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1.1.  OVERALL  SYSTEM  ORGANIZATION 

The  image  processing  software  is  written  to  be  executed  on  a PDF  11A5 
as  a program  under  the  Disk  Operating  System  (DOS).  The  software  system 
exists  as  several  separate  program  load  modules  and  two  files  containing 
system  tables.  The  executive  control  program  and  certain  subroutines  are 
contained  within  one  file  which  is  loaded  into  core  by  DOS  at  execution 
time.  All  other  load  modules  consist  of  program  functions  related  to 
the  various  options  available  to  the  user.  The  option  lists  which  are 
presented  to  the  user  in  frame  format  are  stored  in  one  file  and  the 
messages  used  for  error  reporting  are  stored  in  another. 

The  executive  control  program  oversees  the  overall  operations  of  the 
system.  It  accepts  and  interprets  all  frame  level  input  (user  entries  when 
system,  is  waiting  for  a frame  option  selection).  The  appropriate  action  is 
then  taken  to  load  and  execute  another  program,  or  to  display  a frame, 
whichever  is  indicated  by  the  user  selected  option.  Automatic  recording  of 
the  user/system,  dialogue  and  the  centralized  error  reporting  function  are 
also  handled  by  the  executive. 

The  executive  calls  upon  the  services  of  DOS  to  accomplish  several 
functions.  A DOS  programmed  request  is  used  to  load  the  option  overlays 
into  core  in  preparation  for  their  execution.  As  these  orogram.s  execute, 
they  require  access  to  data  files  stored  on  disk  peripherals.  This  access 
is  gained  by  requests  to  the  executive  which,  in  turn,  uses  DOS's  rrograr-ed 
requests  to  access  the  files.  Several  other  functions,  such  as  stack 
maintenance  and  access  to  peripheral  devices,  are  also  accomplished  via  the 
services  of  DOS. 


The  system  software  can  reside  on  any  disk  in  the  hardware  configura- 
tion that  is  recognizable  to  DOS.  However,  it  is  typically  stored  with.  DOS 
on  its  system  device.  This  places  all  software  on  one  disk,  leavinr  all 
others  free  for  data  storage.  If  there  is  only  one  disk  in  the  system,  it 
m.ust  be  sufficiently  large  to  accommodate  DOS,  the  image  processing  software 
and  all  data  files. 

The  data  files  are  created  within  the  DOS  file  structure  and  can 
therefore  reside  on  any  disk  in  the  system.  All  software  uses  the  DOS  file 
specification  (device,  unit  number,  file  name  and  extension)  when  referencing 
a file,  and  as  a result,  data  file  storage  is  not  limited  to  one  device  as 
with  the  previous  system.  A program  at  any  piver.  time  can  access  files 
which  are  resident  on  several  different  disk  devices. 
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SOFTWARE  ORGANIZATION 


As  previously  mentioned,  the  software  consists  of  an  executive  with 
related  routines  and  several  option  overlays.  The  executive  and  each  of 
the  option  overlays  are  stored  in  completely  separate  files.  DOS  is  used  to 
load  and  execute  the  executive  module  which  then  takes  control.  The  execu- 
tive accesses  the  frame  file  (FRAMES. IPS,  ref.  Appendix  C)  to  initially 
display  frame  0 and  then  to  display  all  other  frames  as  requested  by  the 
user.  Each  option  in  a frame  describes  the  associated  frame  to  be  displayed 
or  an  option  overlay  to  be  executed. 

1.2.1.  Functions  Of  The  System  Frames 

The  frames  are  a key  element  in  tying  all  system  components  together. 

In  addition  to  providing  the  text  to  be  listed  on  the  graphics  display  for 
user  option  selections,  each  frame  contains  a table  consisting  of  a list  of 
three-word  entries  (ref.  Appendix  C).  The  first  entry  is  the  frame  header 
which  identifies  the  frame.  All  other  entries  correspond  in  order  to  the 
displayed  options. 

The  frame  is  loaded  into  memory  by  the  program  "BLDISP",  beginning  at 
the  global  location  "FRMTBL".  The  frame  header  and  option  entries  reside 
in  the  first  portion  of  this  buffer.  The  frame  text  begins  at  "FP.MLOC", 
which  is  the  second  part  of  the  "FRMTBL"  buffer.  The  text  is  packed  in 
RAD50  format  and  therefore  must  be  converted  to  ASCII  prior  to  its  display. 
After  the  text  is  displayed,  this  portion  of  the  buffer  is  used  for  error 
reporting. 

Following  the  display  of  the  frame,  the  system  waits  for  a user  entry. 
If  this  entry  is  an  option  selection,  the  option  number  is  converted  to  an 
index  into  the  frame  table  currently  residing  in  the  "FRMTBL"  buffer.  This 
entry  completely  describes  the  action  to  be  taken.  New  frame  displays  are 
indicated  by  the  characters  "FRM"  packed  into  the  first  word  of  the  entry 
in  RAD50  format.  The  second  word  then  contains  the  reference  number  of  the 
new  frame  to  be  displayed. 

If  the  selected  option  references  an  executable  routine,  the  first 
word  of  the  entry  contains  its  three-character  overlay  reference  numbers 
packed  into  RAD50  format.  This  is  then  combined  with  the  RAD50  packed 
character  "OVR"  to  form  a six  character  name.  A ".LDA"  is  then  appended  to 
complete  the  file  name.  This  file  contains  the  program  to  be  loaded  and 
executed. 

As  previously  mentioned,  each  frame  is  identified  by  a reference 
number.  Frames  are  retrieved  from  the  disk  file  "FRAMES. IPS"  by  converting 
the  number  to  an  offset  to  the  block  in  the  frame  file  that  contains  the 
desired  frame.  The  base  address  of  the  frame  file  is  then  added  to  this 
number  to  obtain  the  absolute  disk  address  of  the  desired  frame. 
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1.2.2.  Overlay  Loading 


To  avoid  the  unnecessary  duplication  of  writing  a prog ran  loader,  the 
executive  was  written  to  use  the  services  offered  by  DOS.  The  programed 
request  ".RUN"  is  used  to  load  the  option  overlays  into  memory  at  a location 
immediately  below  the  memory  resident  routines  (ref.  Appendix  A).  This 
function  also  moves  the  stack  as  required  to  allow  the  overlay  to  be  loaded. 
The  entry  point  for  the  overlay  is  then  extracted  from  the  selected  frame 
option  and  control  is  transferred  to  the  overlay  via  a subroutine  call 
using  general  register  five.  One  overlay  may  have  several  entry  points. 

Each  entry  point  is  referenced  by  a number  which  is  an  offset  in  ’words  from 
the  first  entry  point.  The  first  is  designated  in  the  normal  fashion  via 
the  ".END"  assembler  directive  and  has  an  offset  of  0.  The  second  entry 
point  would  then  have  a word  offset  of  one. 

After  receiving  control,  the  overlay  then  performs  its  programmed 
function  using  the  services  of  the  executive  and  the  memory  resident  routines 
These  references  to  the  executive  subroutines  are  made  possible  by  saving 
the  symbol  table  which  is  generated  when  the  executive  module  is  linked. 

Each  overlay  is  then  linked  with  this  symbol  table  to  resolve  the  global 
references  made  by  the  overlay.  Thus,  complete  linkage  is  attained. 

A large  buffer  space  is  assigned  within  the  executive  program  nodule. 
This  buffer  is  intended  to  be  used  by  the  option  overlays  for  computations 
and  data  file  I/O.  Access  to  this  buffer  is  also  gained  via  the  symbol 
table.  A parameter  in  the  symbol  table  describes  the  size  of  the  buffer 
which  must  be  observed  by  each  overlay.  This  allows  the  system,  to  be  built 
for  differing  amounts  of  memory  available  simply  by  varying  the  value  of 
this  parameter.  The  advantage  gained  by  storing  the  buffer  with  the  execu- 
tive is  that  it  is  only  stored  on  the  disk  once  as  opposed  to  once  for  each 
option  overlay. 

An  option  overlay  can  be  broken  down  into  suboverlays  if  necessary. 

These  suboverlays,  however,  are  loaded  into  core  by  an  entirely  different 
mechanism.  The  autoload  software  described  in  the  "DOS/BATCH  Linker  (LINK) 
Programmer's  Manual"  is  used  to  perform  the  suboverlay  loading.  In  this 
scheme  the  option  overlay  is  made  up  of  a root  section,  which  is  memory 
resident  throughout  the  execution  of  the  option  overlay,  and  several  sub- 
overlays. The  suboverlay  tree  structure  can  be  as  complex  as  allowed  by 
the  DOS  autoload  software. 

The  autoload  feature  has  several  advantages.  First,  the  option  overlay 
and  all  of  its  suboverlays  are  stored  in  one  file,  thereby  limiting  time- 
consuming  file  searches  to  one.  That  one  search  locates  the  file  and  loads 
the  root  section  into  memory.  The  address  of  the  file  is  then  retained  for 
future  suboverlay  loading. 

A second  advantage  is  the  ease  in  which  the  option  can  be  programmed. 

All  overlay  operations  are  transparent  to  the  programmer,  thus  greatly 
simplifying  his  task. 
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One  might  inquire  as  to  why  the  autoload  feature  was  not  used  for  the 
entire  system.  This  reason  becomes  apparent  when  considering  the  require- 
ments of  the  autoload  software.  Each  overlay  in  the  system  must  be  described 
by  a memory-resident  autoload  vector.  There  are  currently  fifty  option 
overlays,  several  of  which  have  suboverlays.  Future  system  additions  are 
expected  to  more  than  double  this  number.  The  memory  requirement  for 
autoload  vectors  would  then  become  very  large.  By  using  the  approach  of 
two  overlay  loading  schemes,  the  autoload  vectors  are  no  longer  permanently 
resident  in  memory.  They  exist  within  the  root  section  of  their  associated 
option  overlays  and  are  therefore  not  only  reduced  in  number,  but  are  in 
memory  only  for  the  duration  of  the  option  execution. 

A second  advantage  is  gained  in  the  ease  with  which  a new  option  can 
be  added  to  the  system.  If  only  autoloading  is  used,  the  entire  system 
would  necessarily  have  to  be  relinked  whenever  a new  option  is  added.  By 
combining  the  two  approaches,  new  options  can  be  added  by  simply  linking 
the  new  software  with  the  executive  symbol  table.  All  previously  existing 
software  can  be  used  without  relinking. 

It  should  be  noted  that  some  autoload  vectors  are  permanently  memory 
resident.  This  is  due  to  the  fact  that  file  system  routines  are  suboverlays 
of  the  executive  and  have  been  implemented  within  the  autoload  scheme. 

This  provides  rapid  access  to  the  file  functions  at  a reduced  memory  re- 
quirement . 


The  ability  to  perform  overlay  autoloads  from  two  separate  files 
(executive  and  option  overlay)  simultaneously  was  achieved  by  replacing  a 
portion  of  the  DOS  autoload  software.  The  executive  now  performs  the 
function  of  determining  from  which  file  the  overlay  is  to  be  loaded.  The 
standard  DOS  library  routine  for  this  function  prohibits  multiple  file 
loading  and  therefore  could  not  be  used. 

One  last  overlay  option  has  been  included.  This  feature  allows  one 
option  overlay  to  request  that  the  executive  load  another  option  overlay. 
When  the  second  overlay  is  loaded,  all  traces  of  the  first  overlay  are 
removed  from  memory  and  the  stack  is  initialized  (all  parameters  removed). 

1.3.  FILE  SYSTEM 

The  image  processing  file  system  is  designed  within  the  DOS  file 
structure.  It  is  essentially  an  interface  between  the  option  overlays 
which  access  the  files  and  the  DOS  file  functions  which  maintain  the  files 
and  their  associated  directories.  Special  considerations  have  been  in- 
corporated into  this  interface  to  achieve  rapid  data  access  and  to  provide 
high-level  file  functions  tailored  to  image  processing  needs. 

All  files  are  created  as  contiguous  files  with  the  exception  of  the 
automatic  log  file  (LOGFIL.IPS)  which  is  linked  to  allow  for  expansion. 

The  contiguous  file  format  allows  several  logical  blocks  of  data  to  be 
transferred  between  disk  and  memory  in  one  access.  This  has  the  effect  of 
greatly  reducing  data-transfer  time. 
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The  internal  structure  of  the  data  files  is  organized  into  fixed 
length  records.  The  record  length,  as  well  as  the  number  of  records,  is 
dependent  upon  the  type  of  data  stored  within.  Each  file  begins  with  a 
256-word  header,  in  which  are  stored  various  parameters  describing  the 
data.  Detailed  descriptions  of  these  parameters  can  be  found  in  Appendix 


The  data  records  immediately  follow  the  header  beginning  in  the  first 
available  logical  device  block  after  the  header.  Records  immediately 
follow  one  another  in  consecutive  order  with  no  intervening  spaces.  This, 
of  course,  means  that  for  certain  record  sizes,  one  or  more  records  may 
cross  device  block  boundaries  at  one  or  more  points  in  the  file. 

A file  is  created  or  retrieved  by  calling  the  appropriate  file  system 
routine  with  an  accompanying  parameter  list  called  a "request  block".  The 
format  of  this  block  is  as  follows: 

Word  Description 

0 Address  of  a character  string  for  requesting 

the  file  specification. 

1,  2 File  name 

3 File  name  extension 

4 Device 

5 Unit  number  in  lew  byte 

File  access  mode  in  high  byte 

6 Address  of  buffer  for  file  operations 

7 Size  of  buffer 

3 Number  of  records  in  file 

9 Record  length 

10  Number  of  consecutive  records  required 

in  core  simultaneously 

11  Record  number  requested. 

The  request  block  describes  the  file  to  be  created  or  retrieved  and  the  buf 
space  to  be  used  for  data  I/O.  This  buffer  space  must  be  dedicated  to  the 
file  until  it  is  closed,  at  which  time  it  is  available  for  other  use. 

If  the  first  word  of  the  request  block  contains  an  address  of  a char- 
acter string,  the  string  is  printed  at  the  keyboard  display  as  a query  fer 
a device  and  a file  name.  The  user  entry  is  then  placed  in  the  request 
block.  If  the  character  string  address  is  not  present,  the  file  specifica- 
tion appearing  in  the  request  block  is  used.  In  either  case,  the  file  is 
created  or  retrieved  as  specified.  The  number  of  records  and  record  length 
must  be  provided  by  the  calling  program  for  create  operations  and  are 
returned  by  the  filing  system  for  retrieve  operations.  The  overlays  reques 
data  records  by  placing  the  number  of  the  desired  record  into  word  11  of 
the  request  block.  The  file  system  routines  then  read  this  record  into 
memory  for  the  overlay.  Due  to  the  typically  sequential  access  of  image 
files  during  processing,  the  file  system  is  designed  to  anticipate  the  next 
records  that  will  be  requested  by  the  option  overlays.  Therefore,  instead 
of  reading  just  one  record,  the  entire  buffer  specified  in  the  request 
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block  is  filled  with  records  that  immediately  follow  the  requested  record. 
The  result  is  that  the  next  request  does  not  require  a disk  access  since 
the  record  has  already  been  obtained  in  a previous  access. 

A similar  procedure  is  followed  when  writing  data  onto  a file.  For 
this  operation,  the  specified  buffer  is  filled  prior  to  transfer  to  its 
disk  file.  However,  sequential  file  output  is  not  only  assumed  in  this 
case,  it  is  expected.  Due  to  the  complexities  involved  in  providing  random 
access  when  records  can  cross  logical  block  boundaries,  this  capability  has 
not  been  included.  For  options  that  require  such  access,  a read/write  mode 
is  available.  In  this  mode  the  buffer  contents  are  transferred  to  the  file 
and  then  the  records  beginning  with  the  requested  record  are  read  into 
memory.  This  eliminates  the  problem  of  preserving  the  overlapping  record 
data. 


Certain  options  require  that  several  consecutive  records  be  in  memory 
simultaneously.  This  is  accomplished  by  specifying  the  number  of  records 
in  word  10  of  the  request  block.  The  file  system  then  insures  that  the 
requested  block  of  records  are  available  in  memory.  Since  the  buffer  space 
required  to  load  a block  of  records  is  computed  when  the  file  is  opened, 
this  information  must  be  provided  at  that  time.  An  error  condition  occurs 
if  sufficient  space  is  not  available. 

1.4.  ERROR  PROCESSING 

A centralized  error  reporting  scheme  has  been  incorporated  into  the 
system.  An  error  condition  detected  by  any  routine  in  the  system  is  reported 
by  a call  to  the  error  reporting  routine  with  two  parameters  which  specify 
the  type  of  error  and  the  message  to  be  listed.  Two  types  of  errors  are 
currently  included.  The  first  type  is  an  error  condition  in  which  remedial 
action  by  the  user  allows  the  interrupted  process  to  continue.  Such  errors 
are  called  recoverable  errors.  The  second  type  of  error  condition  results 
in  a system  state  from  which  a recovery  cannot  be  made.  Such  an  error  is 
termed  a fatal  error. 

The  errors  are  reported  via  a simple  subroutine  call  to  the  error 
processing  routine.  The  error  type  is  specified  by  a number  in  the  calling 
parameter  list.  A "0"  indicates  a recoverable  error  and  a "1"  denotes  a 
fatal  error.  These  correspond  to  two  lists  of  messages  that  are  maintained 
in  a file  under  the  name  of  "ERRORS . IPS".  This  file  has  a header  block  in 
which  relative  block  numbers  within  the  file  are  given  for  the  start  of 
each  error  list.  The  first  action  of  the  error  processing  routine  then,  is 
to  determine  the  base  disk  address  of  the  selected  error  list. 

The  second  calling  parameter  indicates  which  message  in  the  list  is  to 
be  logged.  The  appropriate  message  is  then  read  into  memory  and  printed  on 
the  graphics  display.  If  the  error  is  recoverable,  a normal  subroutine 
return  is  then  executed.  If  the  error  is  fatal,  control  is  transferred 
instead,  to  the  executive  which  then  terminates  the  execution  of  the  option 
overlay  and  removes  it  from  memory. 
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SECTION  2 


PROGRAMMER ’ S MANUAL 


This  section  is  intended  as  a programming  guide  for  developing  new 
software  for  the  image  processing  system.  A variety  of  services  are  offere 
by  the  executive,  the  file  system  and  several  utility  programs.  A large 
number  of  these  services  can  be  conveniently  referenced  via  a set  of  syste- 
macros  (ref.  Appendix  H).  Although  in  some  cases  the  programmer  may  find 
that  directly  inserting  the  code  is  just  as  convenient  as  using  a macro,  th 
should  be  avoided.  By  consistent  use  of  the  macros,  modifications  or  updat 
can  be  made  to  an  entire  system  by  simply  changing  a few  macros.  Without  t 
use  of  macros,  a time-consuming  search  must  be  made  of  all  routines  in  the 
system  for  occurrences  cf  the  code  sequences  being  changed. 

In  the  remainder  of  this  section,  several  programming  conventions  and 
callable  subroutines  are  discussed.  Sufficient  information  is  provided  in 
each  case  to  properly  use  these  subroutines.  Further  details  may  be  found 
the  program  documentation  in  Section  u.  For  this  purpose,  the  name  of  the 
Program  in  which  the  subroutine  is  contained  is  given  here. 

2.1.  SUBROUTINE  CALLING  CONVENTIONS 

All  subroutine  calls  follow  the  general  format  given  below: 

following  the  parameter  list) 


JSR  (reg.),  (subroutine  name) 

BR  (offset  to  first  instruction 
Parameter  list 


This  format  has  two  advantages.  First,  by  including  the  branch  instruction 
the  offset  (lower  byte)  cf  the  branch  gives  the  number  of  parameters.  Fcr 
routines  that  accept  variable  length  lists,  the  number  of  parameters  passed 
can  readily  be  determined. 

The  second  advantage  is  that  DOS  FORTRAN  uses  this  calling  format  with 
register  five  in  the  subroutine  call.  Therefore,  if  the  parameters  are 
referenced  in  the  list  by  their  addresses,  the  routine  is  FORTRAN  callable. 

A general  system  macro  has  been  provided  to  generate  the  proper  sub- 
routine calls.  The  format  of  this  macro  is  as  follows: 


CALL 


nam 


.,P2,P3,P4,P5,F6 


which  expands  to 


JSR  R.5  .name 

BR  (offset  to  first  executable  instruction) 
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.WORD 

PI 

.WORD 

P2 

.WORD 

P3 

.WORD 

P4 

. WORD 

P5 

.WORD 

P6 

The  number  of  parameters  is  optional  within  the  range  of  0 to  6.  If  no 
parameters  are  specified,  the  branch  statement  is  not  generated. 

The  CALL  macro  should  be  used  in  all  cases  where  a specialized  macro  is 
not  available.  In  the  subroutine  descriptions  to  follow,  the  proper  macro  to 
be  used  in  each  case  is  discussed. 

2.2.  GRAPHICS  DISPLAY  INTERACTION 

The  graphics  display  is  the  prime  means  of  communication  with  the 
system.  This  communication  is  accomplished  via  frame  displays  and  user/ 
system  dialogue.  Since  this  is  a storage  display,  it  must  be  erased  and 
rebuilt  from  time  to  time  to  avoid  overwriting  of  information.  This  rebuild 
action  is  under  the  control  of  the  program  "TELEIO"  which  together  with 
"PLOT"  and  "TTYIO"  contains  the  display  I/O  subroutines.  Therefore,  it  is 
imperative  that  the  user  reference  these  subroutines  for  all  display  opera- 
tions. 

Since  this  is  an  interactive  system,  the  programmer  must  frequently 
make  requests  of  the  user  and  accept  his  responses.  These  services  are 
provided  by  the  system  at  two  levels.  The  higher-level  routines  are  those 
which  output  a message  and  input  the  user's  response.  These  consist  of 
routines  to  request  file  specifications  and  numeric  input.  The  lower  level 
routines  simply  output  or  input  character  strings.  These  should  not  be  used 
if  a higher-level  routine  will  satisfy  the  requirement. 

Character  strings  consist  of  ASCII  characters  terminated  by  a null. 
Embedded  carriage  returns  and  line  feeds  are  permitted.  For  normal  user 
communications  the  line  length  should  not  exceed  40  characters.  If  a longer 
message  is  desirable,  it  should  be  sectioned  into  two  or  more  lines  with 
embedded  carriage  returns  and  line  feeds.  It  should  be  noted  that  one 
complete  message  should  not  be  output  in  sections  by  making  several  calls  to 
the  output  routines.  The  initial  lines  of  text  may  be  lost  if  the  display 
is  rebuilt  prior  to  completing  the  output.  If  the  complete  message  is 
formatted  with  carriage  returns  and  line  feeds,  then  the  output  routines  can 
insure  sufficient  display  space  for  the  entire  message. 

The  available  communication  subroutines  and  their  associated  calling 
sequences  are  discussed  below.  The  "CALL"  macro  is  used  in  all  cases  to 
form  the  subroutine  calling  sequence. 
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2.2.1.  Request  File  Snecif ication 


CALL  GETNAM , CHR , BUF 

(Ref.  Program  TTY 10) 

where 

CHR  = Address  of  the  output  character  string 

BUF  = Address  of  a 12-wcrd  buffer  for  return  parameters 

Return  is  via  the  branch  instruction.  Upon  return,  the  twelve-word  b 
contains,  in  order,  a five-word  link  block  and  a seven-word  file  name 
as  defined  for  DOS.  Device  and  unit  default  values  (those  used  when  none  are 
entered  by  user)  are  provided  by  this  routine.  "Wild  card"  specifications  as 
defined  under  DOS  are  returned  unaltered  (520  for  any  parameter  indicates  the 
wild  card). 

It  should  be  pointed  cut  that  file  names  are  normally  requested 
the  file  system  routines  (Para.  2.3).  Only  special  circumstances  req 
use  of  the  "GETNAM"  routine. 

2.2.2.  Recuest  a String  of  Signed  Double  Word  Integer  Numbers 


incut  decimal  numbers : 

CALL  DBLDEC , CHR ,CNT , BUF , IND  ( IND  is  optional) 

(Ref.  Program  TTYI0) 

incut  octal  numbers: 


(Fef.  Program  TTYI0 ) 


(IND  is  optional) 


Address  of  the  output  character  string 

Address  of  a location  containing  the  count  of  numbers  to 
input.  This  count  must  be  satisfied  exactly  or  an  error 
message  is  printed  and  a recuest  is  made  to  retvre  the 


Address  of  buffer  in  which  to  return  the  numbers  in  the 
order  entered.  This  buffer  must  contain  sufficient  spac 
to  store  all  the  numbers  indicated  by  the  second  paramet 
Double  word  values  are  returned  low  order  first  followed 
by  high  order. 

(Optional  parameter)  Address  of  a location  in  which  to 
return  an  indicator.  A negative  one  is  returned  if  a 
CTRL/Z  is  found  to  be  the  first  character  entered  by  the 
user.  Otherwise,  a zero  is  returned. 


This  routine  is  designed  to  allow  one  or  more  numbers  to  be  entered  on 
one  or  more  lines  by  the  user.  For  multiple  line  input  where  the  total 
number  of  lines  is  determined  by  the  user,  the  call  to  DBLDEC  should  be 
contained  within  a loop.  This  call  should  use  the  optional  fourth  parameter 
"IND".  The  loop  is  exited  when  IND  = -1,  which  occurs  when  the  user  indi- 
cates the  end  of  input  by  responding  with  a CTRL/Z. 

2.2.3.  Request  a String  of  Signed  Word  Integer  Numbers 
To  input  decimal  numbers : 

CALL  SNGDEC , CHR , CNT , BUF , IND  (IND  is  optional) 

(Ref.  Program  TTYIO) 

To  input  octal  numbers: 

CALL  SNGOCT ,CHR ,CNT , BUF , IND 

(Ref.  Program  TTYIO) 

The  parameters  and  their  descriptions  are  identical  to  that  given  for 
D3LDEC  except  that  word  values  are  returned  in  the  buffer. 

2.2.4.  Request  a String  of  Signed  Byte  Integer  Numbers 
To  input  decimal  numbers: 

CALL  BYTDEC , CHR , CNT , BUF , IND  (IND  is  optional) 

(Ref.  Program  TTYIO) 

To  input  octal  numbers: 

CALL  BYTOCT , CHR, CNT , BUF, IND  (IND  is  optional) 

(Ref.  Program  TTYIO) 

The  parameters  and  their  descriptions  are  identical  to  that  given  for 
DBLDEC  except  that  byte  values  are  returned  in  the  buffer. 

2.2.5.  Request  a String  of  Floating  Point  Numbers 

CALL  FLTENT ,CHR ,CNT ,E'JF, IND  (IND  is  optional) 

The  parameters  and  their  descriptions  are  identical  to  DBLDEC  except 
two-word  floating  point  numbers  are  returned.  Numbers  are  accepted  in 
either  of  the  following  formats: 

19678.66 
1. 967866E04 

where  both  entries  represent  the  same  number. 
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2.2.6. 


Output  a Character  String 


CALI.  TTYOUT.CKR 

(Ref.  Program  TELE 10) 

where 

CHR  = Address  of  the  output  character  string.  T7Y0UT  will 
append  a final  carriage  return  and  line  feed  when  the 
null  terminator  is  encountered. 

Following  the  call,  the  global  location  "TTYADR"  contains  the  address  of 
the  byte  immediately  following  the  null  in  the  output  string.  An  additional 
output  method  is  detailed  below: 

CALL  TTY0,CHR 

(Ref.  Program  TELEI0) 

where 

CHR  = Address  of  the  output  character  string.  A final  carriage 

return  and  line  feed  are  not  appended  when  the  null 

terminator  is  encountered. 

Following  the  call,  the  global  location  "TTYADR"  contains  the  address  cf 
the  byte  immediately  following  the  null  in  the  output  string. 

2.2.7.  Input  a Character  String 

CALL  TTY IN, EOF 

(Ref.  Program  TELEI0) 

where 

BUF  = Address  of  a buffer  in  which  to  deposit  the  string.  This 
buffer  should  be  of  sufficient  length  to  contain  the 
expected  string.  The  word  immediately  preceding  the 
buffer  should  contain  the  size  of  the  buffer  in  bytes. 
This  number  is  used  by  TTYIN  to  prevent  overflow.  The 
terminating  carriage  return  entered  by  the  user  is 
replaced  with  a null  by  TTYIN. 

A general-purpose  input  buffer  is  provided  within  the  executive  fcr  use 
with  TTYIN.  This  buffer  is  defined  by  the  global  "TTYBL'F".  The  size  of  this 
buffer  (preceding  word)  is  set  to  90  bytes.  Under  no  circumstances  should 
the  size  of  TTYBUF  be  altered. 
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2.2.8.  Specialized  Graphic  Displays 

Certain  functions  require  that  the  graphics  terminal  be  used  for  special 
display  purposes.  In  this  case,  the  display  is  temporarily  under  the  control 
of  the  executing  overlay.  To  gain  control  of  the  display,  the  following 
subroutine  should  be  called: 

CALL  DSABLR 

(Ref.  Program  TELEIO) 

This  disables  the  display  rebuild  software.  The  display  can  then  be  manip- 
ulated by  using  the  graphic  plot  subroutines  below  in  addition  to  any  of  the 
other  terminal  I/O  subroutines.  After  the  specialized  display  mode  is  no 
longer  required,  the  following  call  should  be  made  to  enable  the  display 
rebuild  software: 

CALL  ENABLR 

(Ref.  Program  TELEIO) 

The  current  frame  is  then  redisplayed  by  the  following  call: 

CALL  3LDISP 

(Ref.  Program  BLDISP) 

Another  special  display  feature  is  available  to  the  programmer.  This 
allows  specialized  displays  to  be  presented  and  user/system  dialogue  to  be 
maintained.  To  accomplish  this,  the  address  of  a programmer-supplied  routine 
that  builds  the  specialized  display  must  be  placed  in  the  global  location 
"DSPADR”.  The  following  sequence  of  operations  is  then  performed: 

1.  CALL  DSABLR 

2.  Call  the  routine  that  presents  the  special  graphics  display. 

Space  must  be  reserved  along  the  left  display  margin  for 
dialogue.  This  routine  must  leave  the  alpha  cursor  positioned 
at  the  top  of  the  left  margin. 

3.  CALL  ENABLR 

The  dialogue  can  now  be  maintained  with  the  system.  When  the  dialogue 
reaches  the  bottom  of  the  left  margin,  the  control  software  will  call  the 
routine  whose  address  appears  at  "DSPADR"  to  rebuild  the  display.  Dialogue 
then  continues. 

Upon  exiting  the  special  display  mode,  the  "BLDISP"  routine  should  be 
called  and  the  address  "BLDISP"  should  be  replaced  in  "DSPADR"  to  allow 
normal  frame  rebuild. 


m.-i.  -j.  ' >■»* 
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The  following  is  a collection  of  routines  to  allow  graphic  plots  to  be 
constructed  on  the  display  terminal.  The  display  manual  should  be  consult e 
for  complete  descriptions  of  the  various  plotting  operations.  The  calling 
sequences  are  as  follows  (all  subroutines  are  in  program  PLOT): 

To  put  the  display  in  alpha  mode: 

CALL  ALPHA 

To  put  the  display  in  graphics  mode: 

CALL  GRMODE 

To  clear  the  display  screen: 

CALL  CLEAR 

The  display  is  left  in  alpha  mode  with  the  cursor  at  the  top  of  the  left 
margin. 

To  put  the  cursor  in  the  home  position  (top  left  margin): 

CALL  HOLE 

Following  this  call  the  display  is  in  graphics  mode. 

To  draw  a light  or  dark  vector: 

CALL  PLOT,X, Y 

where 

X = The  address  of  a location  containing  the  X display 

coordinate 

Y = The  address  of  a location  containing  the  Y display 

coordinate 

A dark  vector  is  drawn  if  the  call  is  immediately  preceeded  by  a call  to 
''GRMODE".  Successive  calls  to  "PLOT"  draw  light  vectors  between  the  specif 
consecutive  points. 

To  output  a graphics  string: 

CALL  TTYGP.F,CHR 

where 

CHR  = Address  of  the  output  character  string  which  is  termi- 
nated with  a null. 
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Following  the  call,  the  location  "TTYADR"  contains  the  address  of  the  next 
byte  location  following  the  null. 

The  TTYGRF  subroutine  is  necessary  because  TTYO  and  TTYOUT  interface  to 
the  Tektronix  via  DOS.  The  DOS  teletype  driver  does  not  allow  control 
characters  to  be  printed.  Since  these  characters  are  necessary  for  graphics 
plots,  TTYO  and  TTYOUT  cannot  be  used. 

2.3.  FILE  SYSTEM  SERVICES 

Extensive  services  are  provided  to  the  programmer  for  manipulating 
files.  These  services  include  create,  retrieve,  delete,  and  rename  func- 
tions. Accompanying  the  create  and  retrieve  operations  is  the  ability  to 
read  and/or  write  a file.  Standard  DOS  link  and  file  name  blocks  are  used 
for  the  delete  and  rename  functions.  A more  specialized  parameter  list 
called  a "request  block"  has  been  developed  for  the  create  and  retrieve 
functions. 


2.3.1.  Request  31ock  Format 

The  request  block  is  generated  via  the  macro  "F.REQ"  and  takes  on  two 
general  forms  - one  for  the  create  function  and  one  for  the  retrieve  func- 
tion. For  the  create  function  the  macro  is  invoked  as  follows: 

F.REQ  0 , LBL , CHR , EXT , RECS , LNG , ACES , FTYP , RTYP , NAME 

This  expands  to  the  following  (underlining  denotes  a calling  parameter): 


L3LCHR 

.WORD 

CHR 

(address  of  character  string) 

L BLN AM 

T.RAD50 
J or 

/NAME/ 

(if  parameter  "NAME"  is  non-blank) 

\.W0RD 

0,0 

(if  parameter  "NAME"  is  blank) 

LBLEXT 

. RAD50 

/EXT/ 

(device  name  in  RAD50  format) 

LBLDEV 

.WORD 

0 

LBLUNT 

.BYTE 

0 

(device  unit  number) 

LBLRTP 

.BYTE 

< 4*ACES> 

+ <2*FTYP>  + RTYP 

(record,  file,  and  access  indicator) 

LBLBUF 

.WORD 

FRECOR 

(buffer  for  file  operations) 

L3LSIZ 

.WORD 

CSIZE2 

(size  of  buffer) 

LBLCNT 

.WORD 

RECS 

(number  of  records) 

LBLLEN 

.WORD 

LNG 

(record  length) 

LBLCON 

.WORD 

1 

(number  of  consecutive  records 
required  in  core  simultaneously) 

L3LREC 

.WORD 

0 

(record  number  requested) 

The  macro  call  for  generating  the  request  block  for  the  retrieve  function 
is  : 


F.REQ  1, LBL, CHR, EXT, ACES, NAME 
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This  expands  in  the  same  manner  as  for  the  create  call  with  the  excectior. 
that  the  parameters  P.ECS,  LUG,  FTYP,  and  PTYP,  which  are  not  specified,  are 
automatically  set  to  zero.  The  definition  of  each  of  the  parameters  is 
as  follows: 


r 3i 


REGS  = 


LUG  = 


ACES  = 


2 


FTYP  = 


0 

1 


RTYP  = 


UA 


One  to  three  characters  to  be  used  as  the  first  part 
of  the  parameter  labels. 

Address  of  the  character  string  to  be  output  to  request 
the  file  specification.  A zero  value  implies  that  there 
is  no  character  string  and  that  the  file  specification  i: 
completely  provided  in  the  request  block.  Therefore,  no 
user  interaction  will  result. 

File  extension  which  indicates  the  file  type  with  respec: 
to  the  data  contained  therein.  If  this  argument  is  left 
blank  or  if  the  program  clears  the  location  associated 
with  this  argument,  then  the  filing  system  uses  the 
extension  specified  by  the  user.  If  the  extension  is 
specified  via  the  macro  argument  or  the  program,  then  th< 
user-entered  extension  is  ignored. 

The  total  number  of  records  to  be  in  the  file. 

The  length  of  each  record  in  bytes  (odd  values  are 
acceptable ) 

File  access  type: 

= Read 
= Write 

= Modify  (read  and  write) 

File  type  with  respect  to  structure: 

= Contiguous 

= Linked  (currently  not  implemented) 

Record  type : 

= Fixed  length 

= Variable  length  (currently  not  implemented) 

File  name.  If  the  name  is  to  be  entered  by  the  user  at 
execution  time  or  if  the  name  is  to  be  inserted  by  the 
program,  this  parameter  should  be  left  blank.  If  the 
name  is  known  at  programming  time,  it  should  be  inserted, 
If  temporary  files  are  to  be  created,  the  names  FILE1.TY- 
FILE2.TKP,  ...,  FILEN.TMP  should  be  used.  These  are 
automatically  deleted  upon  closing  the  file  except  when 


* 
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bit  4 of  the  LBLRTP  parameter  is  set.  In  this  case  the 
file  is  closed  and  not  deleted.  Caution  should  be  ex- 
ercised when  using  this  option  since  .TMP  files  must  all 
be  deleted  when  the  overlay  exits. 

All  request  block  parameters  should  be  referenced  by  their  respective 
labels.  Future  system  changes  or  additions  may  result  in  a different  order 
or  number  of  parameters.  Therefore,  if  in  a given  instance  one  parameter 
must  be  referenced  relative  to  another,  then  the  values  defined  by  the  macro 
"EQUATE"  should  be  used.  These  values  are  simply  indexes  into  the  request 
block  relative  to  the  first  parameter  in  the  block.  They  are  referenced  via 
the  last  three  characters  of  the  label  of  their  respective  parameters.  For 
example,  if  the  buffer  length  parameter  must  be  referenced  with  respect  to 
the  buffer  address  parameter,  then  the  programmer  would  use 

LBLBUF+SIZ-BUF 
as  the  relative  address. 

2.3.2.  Creating  Files 

Two  file  system  subroutines  are  available  for  creating  files.  The  only 
difference  between  them  is  that  one  creates  the  file  and  then  opens  it  for 
access  while  the  other  simply  creates  the  file.  The  request  block  parameters 
must  be  initialized  prior  to  either  call  as  discussed  above.  The  one  param- 
eter which  is  of  no  concern  at  this  point  is  the  record  number  requested 
( L3LREC) . This  is  used  by  other  file  functions.  Special  note  should  be 
taken  of  the  file  system  feature  which  requests  the  file  name  from  the  user. 
This  option  is  enabled  or  disabled  as  explained  for  the  character  string 
address  (LBLCHR) . 

To  create  a file  and  open  it  for  access: 

F.CRE  ADR.ALTRET 

(Ref.  Programs  EXEC  and  FILED 


where 


ADR  = Address  of  the  applicable  request  block. 

ALTRET  = Address  of  an  alternate  return  to  be  taken  if  the  user 

responds  with  a carriage  return  to  the  request  for  a file 
name.  This  parameter  is  optional  and  need  not  be  speci- 
fied. When  it  is  not  specified  a carriage  return  alone 
is  reported  as  a recoverable  error. 

To  create  a file  (file  is  not  opened): 


where  the  parameters  are  as  defined  for  the  F.CRE  macro. 

Both  of  the  above  macros  generate  the  appropriate  subroutine  call  to  the 
file  system.  After  each  call  RO  contains  the  memory  address  of  the  file 
header.  If  any  data  is  to  be  inserted  into  the  header,  it  should  be  done  at 
this  point  (the  file  access  must  be  set  for  write  or  read/write).  The  first 
file  access  (see  2.3.4  below)  causes  the  header  to  be  written  into  the  disk 
file  and  to  be  removed  from  memory.  For  the  F.CRES  call,  the  header  is 
provided  for  reference  only  (the  header  is  written  into  the  file  prior  to 
return ) . 

It  should  be  noted  that  the  buffer  specified  in  the  request  block 
following  an  F.CRE  call  is  initialized  for  data  I/O  and  should  not  be  mod- 
ified. This  buffer  is  not  used  for  the  F.CRE$  call.  Instead,  the  header  is 
loaded  into  a buffer  in  the  executive.  This  buffer  is  overwritten,  by  the 
next  F.CRES,  F.RETS,  OR  F.CHK  call. 

2.3.3.  Retrieving  Files 


Files  are  retrieved  in  a manner  similar  to  that  explained  for  the  create 
option  above.  Again  two  options  are  available,  differing  only  by  the  "open" 
operation.  The  request  block  is  prepared  as  instructed  above.  In  this  case, 
the  number  of  records,  the  record  length  and  the  file  and  record  types  are 
return  parameters.  The  instructions  for  the  other  parameters  are  the  same. 
The  option  is  also  available  to  have  the  file  system  request  the  file  name 
from  the  user. 


To  retrieve  a file  and  open  it  for  access: 


F.RET  ADR, ALTRET 

(Ref.  Programs  EXEC  and  FILED 


where  the  parameters  are  identical  to  those  in  the  F.CRE  call  above. 

To  retrieve  a file  (file  is  not  opened): 

F.RETS  ADR.ALTRET 

(Ref.  Programs  EXEC  and  FILED 

where  the  parameters  are  identical  to  those  in  the  F.CRE  call  above. 

Operations  with  reference  to  the  file  header  and  the  specified  buffer 
are  as  explained  for  the  create  operations.  In  this  case,  the  header  is 
provided  only  for  reference  following  the  F.RETS  call.  The  buffer  is  used  r 
F.RET  but  not  by  F.RETS. 
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2.3.4. 


Accessing  File  Data 


Following  a create  or  a retrieve  function  that  also  opens  a file,  the 
file  may  be  accessed  via  the  file  system.  Prior  to  each  call  for  a record  or 
group  of  records,  the  record  requested  parameter  "LBLREC"  should  be  set  to 
the  desired  record.  The  first  record  in  a file  is  record  1.  The  calling 
sequence  to  request  a record  or  group  of  records  is: 

F.PTR  ADR, END 

(Ref.  Programs  EXEC  and  FILE2 ) 

where 

ADR  = Address  of  applicable  request  block. 

END  = Address  of  a location  to  which  control  is  to  be  returned 

if  one  or  more  of  the  records  requested  is  non-existent. 
If  set  to  zero,  the  filing  system  will  report  a fatal 
error  (El. 10.)  when  a non-existent  record  is  encountered. 

Following  each  call  to  F.PTR,  memory  addresses  of  the  first  byte  of  each 

record  requested  are  found  on  the  stack.  For  example,  if  the  programmer 
requests  one  record  (parameter  LBLCON) , the  address  of  the  first  byte  of  that 
record  is  found  on  top  of  the  stack.  If  three  records  are  requested,  then 
three  addresses  are  returned.  In  this  case  the  address  of  the  first  of  the 
three  records  is  found  on  top  followed,  in  order,  by  the  other  two.  The 
number  of  consecutive  records  can  be  set  to  any  number  but  must  not  exceed 
the  value  specified  at  the  time  that  the  file  was  opened. 

2.3.5.  Check  for  File  Existence 


Certain  operations  simply  require  that  a file's  existence  be  verified  or 
that  its  parameters  be  retrieved.  The  following  routine  performs  these 
functions.  The  request  block  is  initialized  as  for  file  retrieval.  The  call 
is: 


F.CHK  ADR, NOFILE 

(Ref.  Programs  EXEC  and  FILED 

where 

ADR  = Address  of  the  applicable  request  block. 

NOFILE  = Address  of  an  alternate  return  if  the  file  does  not 

exist . 

If  the  file  exists,  its  number  of  records  and  record  length  are  returned 
in  the  request  block.  Also,  R0  contains  the  memory  address  of  the  file 
header.  As  with  F.CRE$  and  F.RET$,  the  executive  buffer  is  used  instead  of 
the  buffer  specified  in  the  request  block.  Therefore,  the  desired  header 
information  should  be  extracted  prior  to  any  similar  operation. 
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2.3.6. 


Delete  and  Rename  Functions 


As  previously  mentioned,  the  delete  and  rename  functions  use  the  stand- 
ard link  and  file  name  blocks  as  defined  by  DOS.  The  format  of  the  call  for 
the  delete  function  is: 

F . DEL  ADR, NOFILE 

(Fef.  Programs  EXEC  and  FILE3) 


ADR  = The  address  of  a twelve-word  buffer.  The  first  five 
words  of  this  buffer  contain  the  link  block  and  the 
remaining  seven  words  contain  a file  name  block.  To- 
gether they  specify  the  file  to  be  deleted  and  the  device 
on  which  it  is  located. 

NOFILE  = The  address  of  a location  to  which  the  filing  syste~  is 
to  return  control  if  the  file  is  non-existent.  If  this 
address  is  zero,  then,  upon  encountering  a ncn-exister.t 
file,  the  execution  of  the  program  is  terminated,  an 
error  message  is  printed,  and  control  is  returned  to  the 
executive. 

The  format  of  the  call  for  the  rename  function  is: 


ADR, NOFILE, DUPFIL 

(Ref.  Programs  EXEC  and  FILE3) 


where 


The  address  of  a nineteen-word  buffer.  This  buffer  must 
contain  in  order  a five-word  link  block,  a sever.-wcrd 
file  name  block  for  the  existing  name,  and  a seven-word 
file  name  block  for  the  new  name. 


NOFILE 


As  defined  for  F.DEL  above. 


DUPFIL  = Same  as  NOFILE  except  that  it  applies  in  the  case  when 
duplicate  file  name  is  encountered. 


2.3.7. 


Closing  Files 


All  files  that  have  been  opened  must  be  closed  following  processing. 

Two  calls  are  provided  for  this  function.  First,  a single  file  may  be  closed 
via  the  following  call: 

F.CLOS  ADR 

(Ref.  Programs  EXEC  and  FILES) 


where 


ADR  = Address  of  the  applicable  request  block. 

A second  available  call  will  close  all  files  that  are  currently  open: 

F . SHUT 

(Ref.  Programs  EXEC  and  FILE3) 

If  control  is  returned  to  the  executive  due  to  a fatal  error  occurring 
during  program  execution,  any  open  files  will  be  automatically  closed.  Any 
such  files  that  were  open  for  write  or  modify  access  will  be  marked  in  the 
fifth  word  of  the  header  as  having  been  prematurely  closed.  Subsequent 
accesses  to  these  files  will  cause  the  filing  system  to  warn  the  user  of  the 
file  state  and  allow  him  to  select  an  alternate  file. 

2.3.9.  Extend  a File 

A function  is  provided  to  allow  the  length  of  a contiguous  file  to  be 
extended.  This  function  should  only  be  used  when  necessary  because  it  must 
create  a new  file,  copy  the  old  file  to  the  new  and  delete  the  old  file. 

This  can  be  a time-consuming  process  if  the  file  is  large.  When  required,  it 
is  called  as  follows: 

F. EXT  ADR,EXTADR 

where 

ADR  = Address  of  the  request  block  for  the  file. 

EXTADR  = Address  of  a location  containing  the  size  of  the  ex- 

tension in  256  word  blocks. 

Mote:  The  file  must  be  in  a closed  state. 

2.3.9.  Direct  DOS  File  Access 

Although  accessing  DOS  directly  for  file  services  is  acceptable,  it 
should  be  avoided  if  possible.  For  most  applications,  sufficient  file 
services  have  been  provided.  At  times,  however,  certain  requirements  may 
make  it  necessary  to  deal  directly  with  DOS.  To  this  end,  several  functions 
have  been  provided  in  the  image  processing  system.  These  functions  should  be 
used  to  accomplish  direct  DOS  file  access  so  that  the  image  processing 
executive  can  keep  track  of  all  initialized  and  opened  data  sets.  In  this 
manner,  the  executive  can  remove  them  from  memory  if  the  execution  of  the 
associated  option  overlay  is  terminated  prior  to  its  normal  completion. 
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To  " . INIT"  a data  set: 

CALL  F. IHIT, LNKBLK 


LNK3LK  = 

Address  of  the  associated 

link 

block. 

".OPEN"  a 

file  : 

CALL 

F. OPEN, LNKBLK, FILBLK 

LNK3LK  = 

Address  of  the  associated 

link 

block. 

FIL3LK  = 

Address  of  the  associated 
code  must  be  inserted  in  ' 

f*l  1_0 
the  f 

K leek  • 
ilename 

".CLOSE” 

a file: 

CALL 

F.CLSE, LNKBLK 

LNKBLK  = 

Address  of  the  associated 

link 

block  . 

" . RLSE"  a 

data  set: 

r *r  t 

w nijij 

F. RLSE, LNKBLK 

LNKBLK  = 

Address  of  the  associated 

link 

block . 

2.4.  CORE  RESIDENT  BUFFERS  AND  PARAMETERS 

Certain  buffers  and  parameters  are  made  available  within  the  executive, 
thus  avoiding  the  need  to  define  them  in  each  overlay.  The  main  workir. 
buffer  for  file  I/O  begins  at  the  label  "FRECOR" . The  sine  of  this  buf 
words  is  defined  by  the  symbol  "CSIZE"  and  in  bytes  by  the  symbol  "CSIFE2". 

The  first  memory  location  following  this  buffer  is  given  by  the  label  "ENDCOR". 

As  previously  discussed,  a buffer  is  available  within  the  executive  fcr 
keyboard  input.  This  buffer  is  80  bytes  long  and  begins  at  "TTYBL'F" . The 
word  immediately  preceding  this  buffer  is  permanently  set  to  the  size  cf  the 
buffer  and  should  not  be  changed. 


Two  character  strings  for  requesting  image  file  names  are  core  reside: 
These  strings  are  made  available  to  promote  consistency  and  eliminate  re- 
dundancy. They  are: 
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* u 


rf  t’J 


INNAM:  . ASCIZ  /INPUT  IMAGE  NAME=/ 

and 

OUTNAM:  .ASCIZ  /OUTPUT  IMAGE  NAME=/ 

Since  the  frequency  of  access  of  other  file  types  is  much  lower,  character 
strings  have  not  been  provided. 

2.5.  ERROR  REPORTING 

A centralized  error  reporting  scheme  has  been  adopted  in  the  system, 
rrors  are  reported  by  the  programmer  via  a subroutine  call  accompanied  by 
he  desired  error  class  and  error  number.  Two  classes  of  errors  are  pro- 
vided - fatal  and  recoverable.  Fatal  errors  are  those  which  make  it  impos- 
sible for  the  program  to  continue.  When  such  an  error  call  is  made,  the 
error  reporting  routine  prints  the  specified  message  and  passes  control  to 
the  executive.  Therefore,  the  programmer  should  not  provide  any  return  code. 

Recoverable  errors  are  those  from  which  a recovery  can  be  made,  such  as 
the  user  retyping  an  input  parameter.  In  this  case,  control  is  returned  to 
the  calling  program  after  the  error  is  printed. 

Within  each  error  class  exists  a list  of  error  messages.  Each  message 
is  referenced  by  its  corresponding  number.  The  programmer  simply  passes  the 
number  of  the  error  to  the  error  reporting  routine.  The  list  of  errors  can 
be  found  in  Appendix  D. 

2.5.1.  Fatal  Error  Reporting 

ER. FAT  NUM 

(Ref.  Program  EXEC) 

where 

NUM  = The  error  number  within  the  fatal  error  class. 

2.5.2.  Recoverable  Error  Reporting 

ER.REC  NUM 

(Ref.  Program  EXEC) 

where 

NUM  = The  error  number  within  the  recoverable  error  class. 

2.6.  UTILITY  ROUTINES 

A variety  of  utility  routines  are  available  to  support  the  programmer. 
The  function  of  and  access  to  each  routine  is  discussed  below: 
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2.6.1.  Converting  Double  Word  Binary  to  Decimal  ASCII 

A routine  is  available  to  convert  double  word  binary  numbers  to  decimal 
ASCII  character  strings.  Two  modes  of  access  are  available.  One  mode  passes 
all  parameters  in  general  registers  and  the  other  mode  passes  them  in  a 
parameter  list  following  the  subroutine  call.  The  ASCII  string  is  returned 
within  twelve  bytes,  right  justified,  with  leading  zeroes  blank.  The  minus 
sign,  if  present,  is  right  justified  with  the  number.  After  conversion  the 
number  of  non-blank  characters  returned  is  available  at  the  location  "DIGChT''. 
The  register  mode  call  is  as  follows: 


CI2EAR 

(Ref.  Program  CB2EA) 


The  following  registers  must  be  loaded  prior  to  the  call: 


Address  of  the  buffer  in  which  to  return  the  ASCII  string. 
High  order  part  of  double  word  value. 

Low  order  cart  of  double  word  value. 


Parameter  list  mode: 


n nnr  r»r 

(Ref.  Program  CB2EA ) 


Address  of  double  word  integer  (low  order  cart  first). 


Address  of  a tveive-bvte  buffer  in  which  to  return  the 
ASCII  string. 


2.6.2.  Converting  Single  Word  Binary  to  Decimal  ASCII 

Single  word  binary  conversion  is  also  available.  As  with  double  word 
conversion,  two  modes  are  available  for  passing  parameters.  One  is  via 
general  registers  and  the  other  is  via  a parameter  list  following  the  sub- 
routine call.  The  ASCII  string  is  returned  within  seven  bytes,  right  justi- 
fied, with  leading  zeroes  blank.  The  minus  sign,  if  present  is  right  justi- 
fied with  the  number.  After  conversion,  the  number  of  non-blank  characters 
returned  is  available  at  the  location  "DIGCKT".  The  register  mode  call  is  as 


CALL  SI2DAP. 

(Ref.  Program.  CB2CA) 

The  following  registers  must  be  loaded  prior  to  the  call: 


’ 1 
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R2  = Address  of  the  buffer  in  which  to  return  the  ASCII  string. 

R4  = Binary  value  to  be  converted. 

Parameter  list  mode: 

CALL  SI2DA,SNGINT,3UFADR 

(Ref.  Program  CB2DA) 

where 

SNGINT  = Address  of  single  word  integer. 

BUFADR  = Address  of  a seven-byte  buffer  in  which  to  return  the 

ASCII  string. 

2.6.3.  Converting  Floating  Point  to  ASCII 

Two  conversion  methods  are  available  which  correspond  in  function  to  the 
FORTRAN  "F"  and  "E"  formats.  The  ”F"  format  returns  a number  with  the 

decimal  point  fixed  in  its  proper  position.  The  "E"  format  returns  a number 

with  a decimal  point  plus  a power  of  ten.  The  calling  sequences  follow  (due 
to  the  . 3YTE  parameters,  the  CALL  macro  may  be  inconvenient): 

F format  conversion: 

JSR  RS,FPASCF  (Ref.  Program  FPASC) 

3R  .+10. 

. 3YTE  W 

.BYTE  D 

.WORD  ARG 

.WORD  (Continuation  of  ARG) 

. WORD  8UF 

where 

W = The  width  of  the  field  of  characters  to  be  returned. 

D = The  number  of  digits  desired  to  the  right  of  the  decimal 

point. 

ARG  = The  two-word  floating  point  number. 

3UF  = Address  of  the  buffer  in  which  the  characters  are  to  be 

returned. 
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E format  conversion: 


JSR  RS ,FPASCE  (Ref.  Program  FPASC) 

BR  .+10. 

(The  parameters  and  their  descriptions  are  identical  to  those  for 
FPASCF . ) 

If  the  format  is  unacceptable,  all  characters  in  the  return  buffer  are 
set  to  *' s.  In  "E"  format,  two  ;':'s  are  returned  for  the  exponent  if  it  is 
greater  than  99.  Either  error  condition  causes  the  "C"  bit  in  the  processor 
status  register  to  be  set.  This  bit  is  otherwise  cleared. 

2.6.^.  Convert  Internal  ASCII  Strings  to  Binary 

Two  routines  are  available  for  converting  numeric  ASCII  strings  to 
binary.  They  are  called  as  follows: 


convert 

decimal  ASCII  to  binary 

CALL 

CONV10 

convert 

octal  ASCII  to  binary: 

CALL 

C0JIV8 

For  both  routines,  the  address  of  the  ASCII  string  rust  be  provided  in  ?2. 
The  binary  result  is  returned  in  Rl.  The  ASCII  string  car.  be  terminated  by 
a null  or  a comma. 

2.6.5.  Convert  Radix  50  Packed  Characters  to  ASCII 


This  routine  converts  radix  50  packed  characters  to  ASCII.  The  call  is 
as  follows: 


CALI, 


where 

RAD 50  = 
ASCII  = 
COUNT  = 


RAD2AS , RAD 50 , ASCII, COUNT 
(Ref.  Program  RAD2AS) 


Address  of  the  first  were  in  the  radix  50  packed  string 
of  words. 

Address  of  a buffer  in  which  the  ASCII  string  will  be 
returned. 

The  number  of  radix  50  packed  words. 
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m p*  m 


Save  and  Restore  General  Registers 


This  routine  saves  and  restores  general  registers  RO  through  R5  using 
the  stack.  No  parameters  are  passed. 


Saving  registers: 


SAVREG 

(Ref.  Program  SAVER) 


Restoring  registers: 


2.6.7. 


CALL  RSTREG 

(Ref.  Program  SAVER) 

Save  and  Restore  Floating  Point  Registers 


This  routine  saves  and  restores  the  floating  point  registers  ACO  through 
ACS,  the  floating  point  processor  interrupt  vector,  and  the  floating  point 
status  register  using  the  stack.  No  parameters  are  passed. 


Save  FPU  status: 


Restore  FPU  status: 


SAVFPS 

(Ref.  Program  SARFPS) 


CALL  RSTFPS 

(Ref.  Program  SARFPS) 

2.6.8.  Square  Root  of  a Double  Word  Integer 

This  routine  calcualtes  the  square  root  of  a double  word  integer.  All 
registers  are  unaffected  by  this  routine.  The  call  is: 

CALL  DPSQRT,DBLINT 

(Ref.  Program  SQRT) 

where 

DBLINT  = Address  of  the  double  word  integer  (low  order  first). 

Upon  return  the  square  root  is  found  in  the  first  word  of 
the  double  word.  The  second  word  is  zero. 

2.6.9.  Square  Root  of  a Single  Word  Integer 

This  routine  calcualtes  the  square  root  of  a single  word  integer.  All 
registers  are  unaffected  by  this  routine.  The  call  is: 
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CALL 

SQRT, SNGINT 

(Ref.  Program  SQRT) 

where 

SNGINT  = 

Address  of  the  single 
location  contains  the 

word  integer, 
square  root. 

Upon  return  this 

2.6.10.  Partitioning  Core 


This  routine  partitions  the  FRECCR  buffer  into  specified  fractional 
parts  and  loads  the  address  and  size  of  each  partition  into  their  correspo 
ing  file  request  blocks.  The  call  is  (a  macro  is  not  provided): 

JSR  R5,PAP.C0R 

3R  . + (n+l):’!t- 

.WORD  DENOM 

. WORD  NUMER1 

.WORD  3UFAD1 

.WORD  NUMER2 

.WORD  BUFAD2 


. WORD  NUMERn 

.WORD  BUFADn 

where 

DENO”  = The  denominator  of  the  fractional  partitions.  Each 

partition  is  expressed  as  a fraction  of  the  total; 
therefore,  the  denominator  is  the  same  for  ail  parti- 
tions. 


NUMER1 -NUMERn  = The  numerators  for  expressing  the  size  of  the  n parti- 

tions. 


BUFADl-BUFADn  = The  n addresses  of  the  buffer  address  parameters  in  th 
respective  request  blocks. 


The  CALL  macro  was  not  shown  here  due  to  the  fact  that  it  is  limited  to  si 
parameters.  However,  for  partitioning  calls  of  six  parameters  or  less,  it 
can  be  used. 
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2.7. 


LOADING  OPTION  OVERLAYS 


The  executive  provides  the  capability  for  one  option  overlay  to  request 
that  another  be  loaded  and  executed.  This  should  not  be  confused  with  the 
autoload  overlay  facility.  In  this  case,  the  called  overlay  completely 
destroys  the  calling  overlay.  The  only  return  that  can  be  made  to  the  first 
overlay  is  for  the  second  one  to  initiate  a request  to  the  executive  to  load 
the  first  one.  The  second  overlay  is  then  destroyed  when  the  first  one  is 
loaded.  The  overlay  call  request  is  accomplished  via  the  following  macro: 

LOAD  NUM.ENT 

where 

NUM  = Three  ASCII  characters  corresponding  to  the  last  three 
characters  (overlay  number)  of  the  file  name  of  the 
overlay  to  be  loaded. 

ENT  = The  number  of  the  entry  point  (0  is  the  first  entry 

point)  to  be  used  in  the  called  overlay.  Note  that  this 
parameter  allows  any  addressing  mode,  i.e.,  the  first 
entry  point  may  be  specified  as  "#0". 
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2.8. 


MISC.  MACROS 


This  section  discusses  a number  of  macros  which  may  be  useful  to  the 

programmer.  Use  of  these  macros  is  at  the  option  of  the  programmer  with 
the  exception  of  the  EQUATE  macro.  This  macro  should  always  "be  used  when 
services  it  provides  are  required.  Refer  to  DOS  documentation  for  detaile 
information  concerning  DOS  parameter  blocks. 


2.3.1. 


Partitioning  Core  Buffers 


This  macro  partitions  the  specified  core  area  into  two  equal -length 
buffers  and  deposits  the  start  address  and  size  of  each  ir.  their  respective 
request  blocks.  The  user  specifies  the  core  space  which  is  to  be  partitioned. 
The  "FRECCR"  buffer  is  used  as  a default  value.' 


C0RD2 


ADDR1 , ADDR2 ,N0TL0W 


which  expands  to 


#FRECOR,P.u  ’ 
i“CSIZE,R3 
R4 , ADDP.l 

R3 , ADDR1+SIZ-BUF 

R3,R4 

R4,ADDR2 

R3 , ADDR2+SIZ-BUF 


(macro  as  defined  below) 

(included  only  if  NCTLOW  is  blank) 


ADDR1  = The  address  of  the  buffer  address  parameter  within  the 
first  request  block. 

ADDR2  = The  address  of  the  buffer  address  parameter  within  the 
second  request  block. 


NOTLOW  = 


A dummy  value.  If  specified,  the  programmer  must  provide 
the  core  area  to  be  partitioned  and  its  size  in  words  in 
registers  R4  and  R3,  respectively.  If  this  parameter  is 
left  blank,  the  values  "FRECCR"  and  "CSIZE"  are  loaded 
into  R4  and  R3,  respectively. 


SIZ  and  BUF=  As  defined  for  the  EQUATE  macro  below. 

2.5.2.  Move  a Specified  Number  of  Bytes 

This  macro  generates  code  to  move  a specified  number  of  bytes  from  one 
location  to  another. 


BYTMOV  FROM ,REG1 ,T0 ,REG2 ,CNT ,REG3 
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fL  r-t 


which  expands  to 


r 


.ENABL 

MOV 

MOV 

MOV 

1$:  MOVE 

SOB 

. DSABL 

where 

FROM  = 
70 

CNT  = 

REG1.REG2 
S REG 3 = 

2.3.3.  Definit 


This  macro  defines  the  system  parameters  via  equate  statements. 

EQUATE  (no  parameters) 

which  expands  to  (all  numbers  are  octal  except  where  a decimal  point  appears) 


CRE 

= 

0 

RET 

= 

l 

RD 

= 

l 

WR 

= 

2 

MO 

= 

3 

CONTIG 

= 

0 

LINKD 

= 

1 

FLEN 

r 

1 

VLEN 

= 

1 

CR 

= 

15 

LF 

r 

12 

CHR 

= 

0 

NAM 

= 

2 

EXT 

= 

6 

DEV 

= 

10 

UNT 

= 

12 

RTP 

= 

13 

BUF 

= 

14 

SIZ 

= 

16 

CNT 

= 

20 

LEN 

= 

22 

CON 

= 

24 

I 2-24 

# 

* 


LSB 

#FR0M,REG1 

#T0,REG2 

flCNT , REG3 

( REG1)+ , ( REG2 )+ 

REG3.1S 

LSB 


Address  of  first  byte  to  be  moved. 

Address  to  which  the  first  byte  is  to  be  moved. 
The  number  of  bytes  to  be  moved. 


General  registers. 

. of  System  Parameters 


R EC  = 26 

LINMAX  = 33 

HDRSIZ  = 62 

where  the  following  pertains  to  specifying  a request  block: 

CRE  = Specifies  the  create  function. 

RET  = Specifies  the  retrieve  function. 

RB  = Specifies  read  only  access. 

WT  = Specifies  write  only  access. 

MO  = Specifies  read  and  write  access. 

CONTIG  = Specifies  a contiguous  file. 

LINKD  = Specifies  a linked  file. 

FLEN  = Specifies  a fixed  length  record. 

VLEN  = Specifies  a variable  length  record. 

The  following  define  ASCII  codes: 

CR  = ASCII  carriage  return. 

LF  = ASCII  line  feed. 

The  following  define  the  positions  cf  the  parameters  within  the  request  block 
relative  to  the  beginning  of  the  block: 

CHR  = Character  string  address  parameter. 

NAM  = File  name  parameter. 

EXT  = File  extension  parameter. 

DEV  = Device  parameter. 

UNT  = Unit  number  parameter. 

RTP  = Record  type  parameter. 

BUF  = Buffer  address  parameter. 

SIZ  = Buffer  size  parameter. 

CUT  = Number  of  records  parameter. 


Fecord  length  parameter. 
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CON  = 

Number 

REC  = 

Record 

Number  of  contiguous  records  parameter. 

Record  requested  parameter. 

The  following  refers  to  frame  displays : 

LINMAX  = Number  of  lines  of  dialogue  to  allow  before  rebuilding 
the  display. 

The  following  refers  to  the  header  established  by  the  file  system  within 
the  buffer  specified  in  a request  block: 

HDRSIZ  = Size  of  file  I/O  buffer  header  in  bytes. 

2.8.4.  Definition  of  Floating  Point  Registers 

This  macro  defines  six  mnemonics  for  use  in  referencing  the  floating 
point  processor  registers. 


REGS 

which  expands  to 

ACO  = 
AC1  = 
AC2  = 
AC  3 = 

AC4  = 
AC  5 = 


(no  parameter  list) 


%0 

%1 

%2 

%3 

%4 

%5 


where 


2.8.5. 


ACO  through  AC5  = Floating  point  register  mnemonics. 
Inserting  File  Header  Text 


This  macro  is  used  to  insert  a character  string  into  a file  header.  The 
memory  address  of  the  beginning  of  the  header  is  expected  to  be  in  RO.  Up  to 
three  separate  character  strings  can  be  specified  for  transfer  into  the 
header. 


HDRTXT 

which  expands  to 

ADD 

MOV 

MOVB 

BNE 


ADR1 , ADR2 , ADR3 


#384. ,R0 
ADR1.R1 
(R1)+,(R0)+ 
.-2 


t 

* 
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DEC 

RO 

1 

MOV 

ADR2.R1 

1 

' This 

code  is 

generated 

MOVB 

(R1)+,(R0)+ 

1 

r only 

if  ADR2 

is  not  blank 

BNE 

.-2 

J 

DEC 

RO 

s 

MOV 

ADP3.R1 

1 

^ This 

code  is 

generated 

MOVB 

(R1)+,(R0)+ 

1 

only 

if  A DR 3 

is  not  blank 

BNE 

.-2 

\ 

J 

Note  that  any  addressing  mode  is  legal  for  ADR1,  ADR2  and  ADR3.  For  example, 
if  the  lable  "MSO"  is  attached  to  a character  string  its  address  is  specified 
by  "#MS0". 

2.8.6.  Pushing  and  Popping  Stack  Items 

These  two  nacros  s imply  push  or  pop  up  to  six  items  to  or  from  the  stack. 
If  any  parameter  is  omitted,  its  corresponding  line  of  code  is  not  generated. 

To  push  items  onto  stack: 


PUSH 

which  expands  to 


A,B,C,D,E,F 


MOV  A,-(SP) 

MOV  B,-(SP) 

MOV  £,-(SP) 

MOV  2,-(SP) 

MOV  E,-(SP) 

MOV  F,-(SP) 

To  pop  items  from  stack: 

POP  A,B,C,D,E,F 

which  expands  to 

MOV  (SP)+,A 

MOV  (SP)+,B 

MOV  (SP)+,C 

MOV  (SP)+,D 

MOV  (SP)+,E 

MOV  (SP)+,F 

2.8.7.  Defining  a DOS  Link  Block 

LNKBLK  CHR , RET , LDN , NWTF , UN , P DN 

which  expands  to  (underlining  indicates  a calling  parameter): 


CHRLNB : 


.WORD 

.WORD 


1 


1 

* 

. RAD50 
or 

_ . RAD50 
.BYTE 
.BYTE 
'RAD50 

or 

.RAD 50 

/ / (if  LDN  is  left  blank) 

/LDN/  (if  LDN  is  non-blank) 

NWTF 

UN 

II  (if  PDN  is  left  blank) 

/PDN/  (if  PDN  is  not  blank) 

where 

CHR  = 

One  to  three  characters  to  be  used  as  the  first 
of  the  parameter  label. 

characters 

RET  = 

Error  return  address  if  the  data  set  cannot  be  initialized. 

LDN  = 

Logical  device  name  as  defined  under  DOS. 

NWTF  = 

Number  of  words  to  follow  (physical  data  set  name  is  the 
first  word). 

UN 

Unit  number. 

PDN  = 

Physical  data  set  (device)  name  as  defined  under 

DOS. 

2.8.8. 

Defining 

a DOS  File  Block 

FILBLK 

CHR , RET , HO , FI LNAM , EXT , UIC , PC 

which  expands  to 

CHREP.C : 
CHP.FNB : ' 

.WORD 
.BYTE 
.3YTE 
i .WORD 
< or 

' .RAD 50 
".PAD50 
.WORD 
. WORD 

0 

HO 

0 

0,0,0  (if  FILNAM  is  left  blank) 

/FILNAM/  (if  FILNAM  is  not  blank) 
/EXT/ 

UIC 

PC 

where 

OHR  * 

one  to  three  characters  to  be  used  as  the  first 
•ers  of  the  parameter  labels. 

charac- 

PET  * 

rrror  return  address  if  the  file  operation  is  unsuccess- 
ful. 

*«.  ■ 

-u  -pen  :ode  (see  DOS  documentation  for  codes). 

f 

T ’ NAP  * 

ix -character  file  name. 

1 

2-28 


* 

* 


ii 


j 


'"’6  9. 


UIC  = 
PC  = 
De  finis 

nt’pqnjj 


which  expands  to 
CHRM5C : 

CHRABC : 


Three-character  file  name  extension. 
User  ID  code. 

Protection  code. 
a DOS  3uffer  Header 
CHR  ,MBCNT , MODE , ABCNT  ,PNTP. 


MB  CUT 

mode 

0 

ABCNT 

PNTR 


(appears  only  if  PNTP  is  not 


CKR  = One  to  three  characters  to  be  used  as  the  first 
characters  of  the  parameter  labels . 

MBCNT=  Maximum  byte  count  in  buffer. 

MODE  = Data  transfer  mode. 

ABCNT  = Actual  byte  count  fcr  transfer. 

PNTR  = Starting  address  of  buffer  for  dump  mode. 

2.S.10.  Defining  a DOS  TRAN  Block 

TRNBLK  CHR , DBM , BUFR , WCNT , FL'NC 

which  expands  to 


CHRTNE : 

. WORD 

DBN 

CHR3UF : 

. WORD 

BUFR 

H 

O 

\tr. 

a: 

|u 

.WORD 

WCNT 

.BYTE 

FUMC 

CHRTST : 

.BYTE 

6 

.WORD 

0 

One  to  three  characters  to  be  used  as  the  first 
characters  of  the  parameter  labels. 

Address  of  buffer  for  transfer. 

Number  of  words  to  transfer. 


•— ,1 


FUNC  = Function  to  perform. 

2.8.11.  Defining  a DOS  Record  Block 

REC3LK  CHR , FUNC , 3UF , RLEN , HORN , LORN 

which  expands  to 

CHRRCB : . BYTE  FUNC 

. BYTE  0 

.WORD  BUF 

. WORD  RLEN 

.WORD  HORN 

. WORD  LORN 

where 


CHR  = One  to  three  characters  to  be  used  as  the  first  three 
characters  of  the  parameter  labels. 

3UF  = Address  of  buffer  for  transfer. 


RLEN  = Record  length  in  bytes. 

HORN  = Record  number  (high  order). 
LORN  = Record  number  (low  order). 


Defining  a BLOCK  Block 


3LK3LK  CHR, FUNC, BNUM, BUF, LEN 

which  expands  to 


CHRBKB : 

.BYTE 

FUNC 

.BYTE 

0 

CHRBNM: 

.WORD 

BNUM 

.WORD 

BUF 

.WORD 

LEN 

where 


CHR  = One  to  three  characters  to  be  used  as  the  first  three 
characters  of  the  parameter  labels. 

FUNC  = Function  to  be  performed. 

BNUM  = Requested  block  number. 

* 

BUF  = Address  of  buffer  for  transfer. 

LEN  = Length  of  buffer. 
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LINKING  THE  USER  PROGRAM 


The  user-developed  program  is  easily  linked  for  execution  under  the  image 
processing  system.  Any  name  can  be  assigned  to  the  load  module.  The  linking 
sequence  is  as  follows: 

name,LP:  < IPS . STB , user- supplied  programs, LIBR/T: 35700/E 

The  library  module  (LIBR)  is  required  only  if  routines  contained  therein 
are  referenced.  The  top  switch  (/T: 35700)  is  dependent  upon  the  value  used 
for  building  the  system  (Ref.  Appendix  G).  The  value  given  here  is  that  used 
for  implementation  in  28K  words  of  memory. 

The  overlay  autoload  facility  is  fully  described  in  "DOS/BATCH  Linker 
(LINK)  Programmer's  Manual”.  In  this  case,  all  input  file  names  appear  in 
an  overlay  descriptor  file  which  is  also  described  in  the  "LINK"  manual.  The 
symbol  table  file  "IPS. STB"  must  be  specified  in  the  overlay  descriptor  file. 
The  autoload  software  is  linked  with  the  executive  module  and  therefore  need 
not  be  specified. 

The  user  program  is  then  executed  through  the  "CALL  USER  PROGRAM"  option 
in  Frame  13.  The  program  is  then  referenced  by  its  load  module  name.  The 
user  ID  number  is  required  if  the  program  was  linked  under  another  UID.  The 
device  is  assumed  to  be  the  system  software  device. 

An  entry  point  must  also  be  entered  when  executing  the  program.  The 
first  entry  point  is  "1"  and  is  specified  in  the  program  via  the  ".END" 
assembler  directive.  The  second  entry  point  is  the  first  entry  plus  one 
word . 

The  program  must  exit  to  the  executive  upon  completion  via  an  "RTS  F:". 


2.10. 


DEBUG  FACILITY 


The  DOS  program  "ODT"  can  be  used  for  program  development.  However, 
due  to  the  limiter'  space  for  option  overlays  a special  system  must  be  built 
in  which  ODT  is  maue  memory  resident.  This  system  is  built  using  the  batch 
stream  contained  in  files  IPSODT.BAT  and  IPSBLD.BAT.  Appendix  G provides 
details  for  this  procedure. 

After  this  system  is  built  the  user  program  can  be  linked  with  the  new 
system  symbol  table. 

Program  execution  using  ODT  is  then  effected  in  a special  way.  The 
following  steps  must  be  taken: 

1.  Use  the  DOS  GET  command  to  load  the  image  processing  system: 

$GET  IPS 

2.  Call  ODT: 

SOD 

3.  Set  a breakpoint: 

*nnnnnn/B 

where  nnnnnn  is  the  address  of  the  label  E.OVR  found  in  the  IPS. STB 
section  of  the  user  program  load  map. 

4.  Start  system: 

*m mmmmm/G 

where  mmmmmm  is  the  start  address  given  by  the  label  E.EXEC  found 
in  the  IPS. STB  section  of  the  user  program  load  map. 

The  system  is  then  used  in  the  normal  manner.  When  any  option  is  selec- 
ted that  causes  an  option  overlay  to  be  loaded,  the  previously  set  breakpoint 
is  encountered.  This  breakpoint  appears  at  a point  in  the  executive  after 
the  overlay  has  been  loaded,  but  just  prior  to  its  execution.  Therefore, 
for  regular  system  overlays,  the  ODT  proceed  command  (;P)  can  be  given. 

The  user  program  is  executed  in  the  normal  fashion  via  the  "CALL  USER 
PROGRAM”  option.  When  this  option  is  selected,  the  breakpoint  will  be  encount- 
ered. The  proceed  command  should  be  issued.  The  program  name  and  entry  point 
are  then  entered  after  which  the  breakpoint  will  again  be  encountered.  At 
this  point,  the  user  program  is  in  memory  and  breakpoints  can  be  set  within 
for  debugging. 
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■ectioi:  3 


PERMANENT  SOFTWARE  ADDITIONS 


a completely  open- 
The  procedures  to  be 
arc  discussed  in 

3.1.  BUILDING  THE  NEW  OPTION  OVERLAY 


The  image  processing  system  has  beer,  designed  as 
ended  system  with  respect  to  new  software  additions, 
followed,  which  are  quite  simple  and  straightforward, 
following  paragraphs. 


The  suggested  procedure  for  developing  new  software  prior  to  its 
permanent  incorporation  is  to  follow  the  guidelines  for  creating  a user 
program  given  in  Section  2.  When  it  is  operating  correctly  and  has  been 
determined  to  be  of  general  inte-rest  to  system  users,  it  can  then  be  perma- 
nently incorporated  into  the  operating  system. 


The  first  step  is  to  link  the  program  with  needed  subroutines  to  form 
the  overlay  load  module.  The  linking  sequence  is  identical  to  that  for  the 
user  program  except  that  a special  name  must  be  used  and  the  output  load 
module  must  be  stored  under  the  user  ID  number  that  is  used  for  the  system 
software.  The  name  must  consist  of  six  characters  where  the  first  three 
are  "OVR."  The  last  three  characters  are  formed  from  the  number  of  the 
overlay.  This  can  be  any  number  that  is  not  currently  used  (reb.  Appendix 
Typically,  these  numbers  are  assigned  sequentially  for  ease  of  syste~ 
management . 

Consider,  for  example,  that  an  overlay  is  being  linked  from  a routine 
named  "NEWJOB"  which  references  library  subroutines.  Let  us  assume  that  th 
next  available  overlay  number  is  32.  The  link  sequence  is  then  entered  as 

follows  : 


CVR083/CO,LP:  < IPS.STE,  NEWJOB,  LIBR/T: 3E70Z/E 

The  switch  "/CO"  is  used  to  force  the  output  file  to  be  created  in  contiguc 
format.  By  doing  so,  slightly  faster  overlay  load  times  are  realized.  The 
top  switch  is  set  as  discussed  in  Section  2. 

This  completes  the  overlay  building  task.  The  programmer  can  now 
proceed  to  the  next  task  which  is  entering  the  overlay  option  into  a frame. 

3.2.  ENTERING  A NEW  OPTION  INTO  A FRAME 


The  second  and  last  step  in  permanently  adding  a new  system  option 


irst  task 


tr.en  is  to 


Each  frame  contains 


to  create  a new  entry  in  the  appropriate  frame.  The 
select  the  frame  to  which  the  option  will  be  added, 
options  which  are  closely  related  in  function.  The  new  option  should 
therefore  be  added  to  the  frame  which  describes  its  function. 


The  entry  is  made  by  editing  the  file  "FRAMES. SRC"  or  by  modifying  the 
frame  card  deck  and  then  loading  this  deck  into  "FRAMES. SRC"  via  PIP  (Ref. 
Appendix  C).  In  either  case  the  option  entry  is  made  in  the  same  format. 
For  purposes  of  illustration  let  us  assume  that  an  entry  is  being  created 
for  the  previously  linked  overlay  "OVR083"  and  that  the  option  is  to  appear 
as  "EXPAND  IMAGE"  in  the  frame  display.  The  entry  is  made  as  follows: 


OVR083 

* 


'Column  1 


0 

f 

•^Column  9 


EXPAND  IMAGE 


Column  33 


The  column  numbers  refer  to  card  columns.  '.Then  using  the  editor  to  edit 
the  file,  spacing  should  be  accomplished  with  blanks.  Tab  characters  are 
not  accepted  by  the  frame  building  software. 

The  first  entry  beginning  in  column  one  is  the  name  of  the  file  in 
which  the  overlay  is  stored.  The  entry  in  column  nine  is  the  entry  point 
number.  The  first  entry  point  is  specified  by  "0",  the  second  "1",  etc. 

The  last  entry  begins  in  column  33,  which  is  the  text  that  appears  in  the 
frame  display.  Note  that  the  option  number  is  not  specified.  The  frame 
display  software  assigns  the  option  numbers  on  the  basis  of  order  of 
appearance. 

After  the  file  FRAMES. SRC  has  been  prepared  with  the  new  entry,  the  frame 
formatting  software  must  be  called.  This  is  accomplished  under  DOS  by 
entering  the  following  command: 

RUN  FRAMES 

When  the  formatting  is  complete  the  following  is  printed: 

FRAMES. IPS  CREATED 

The  newly  modified  system  is  then  ready  for  use. 

The  function  of  the  "FRAME"  program  is  to  convert  the  "FRAMES. SRC"  file 
which  is  in  the  user-criented  format  to  the  "FRAMES. IPS"  file  which  is  in  the 
system  format  (Ref.  Appendix  C).  This  procedure  greatly  simplifies  frame 
updates. 


3.3.  CREATING  A NEW  FRAME 

It  may  be  necessary  to  create  another  system  frame  if  new  software  does 
not  fall  into  any  of  the  existing  frame  categories.  In  this  case  several 
new  lines  must  be  entered  into  the  FRAMES. SRC  file.  The  different  types  of 
line  entries  will  be  discussed  in  the  following  paragraphs.  The  programmer 
is  referred  to  Appendix  C for  the  current  FRAMES. SRC  file  listing  which  can 
serve  as  a guide  to  creating  the  new  frame. 
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The  first  line  type  is  sinply  a comment.  This  is  indicated  by  a semicolon 
in  column  one.  A blank  in  column  one  has  the  same  effect.  In  either  case 
the  line  content  is  ignored  by  the  FRAMES  program. 

Another  line  that  has  no  effect  on  the  final  product  consists  of  only  a 
form  feed  character  in  column  one.  To  allow  such  a line  to  be  specified  in 
the  card  deck,  a special  control  card  heads  the  deck.  This  control  card 
causes  the  card  reader  input  to  be  interpreted  as  ASCII  format. 

The  third  line  type  specifies  the  total  number  of  frames  in  the  file. 

This  line  contains  only  one  entry  which  is  a number  beginning  in  column  one. 

Only  one  line  of  this  type  can  occur  in  the  file  and  it  must  precede  all 
frames.  If  a new  frame  is  to  be  added,  this  number  must  be  modified. 

The  next  line  type,  is  the  frame  header.  The  first  three  columns  must 
contain  the  characters  "FRM".  The  next  three  characters  must  consist  of 
the  frame  number.  The  last  entry  on  this  line  type  is  the  frame  header  text 
which  begins  in  column  33. 

This  brings  us  to  the  frame  option  lines  which  may  be  one  of  two  types. 

The  first  type  causes  a transfer  to  a new  frame.  It  is  indicated  by  the 
characters  "TRNFRM"  in  columns  one  through  six.  The  number  of  the  frame  tc 
be  displayed  by  the  option  begins  in  column  9 and  the  text  to  be  displayed 
for  the  option  begins  in  column  33. 

The  other  option  type  causes  an  overlay  to  be  loaded  and  executed.  In 
this  case  the  first  six  columns  contain  the  file  name  cf  the  overlay.  The 
overlay  entry  point  number  which  corresponds  to  the  option  begins  in  column 
nine.  As  in  the  previous  case,  the  option  text  begins  in  column  33. 


One  final  line  type  remains  to  be  discussed.  This  type  signals  the  end 
cf  the  frame  and  consists  of  simply  the  characters  "END”  in  the  first  three 
columns . 


From  these  various  line  types  the  new  frame  must  be  constructed.  The 
next  consecutive  frame  number  that  is  not  in  use  should  be  assigned  tc  the 
frame.  The  final  task  is  to  enter  the  name  of  the  frame  as  an  option  in  frame 
0 and  to  execute  the  FRAMES. SRC  program. 

3.4.  ADDING  A NEW  ERROR  MESSAGE 

If  a new  error  message  is  required,  it  can  be  added  in  a manner  similar 
to  adding  a frame  entry.  In  this  case  the  file  ERRORS. SRC  is  edited  via  the 
editor  or  by  changing  its  associated  card  deck.  The  program  "MESAGE"  is  then 
executed  via  the  DOS  RUN  command  to  form  the  file  ERRORS. IPS.  The  format 
of  this  file  and  the  current  contents  of  the  ERRORS. SRC  file  are  given  in 
Appendix  D. 

Each  new  error  must  be  assigned  a type  and  a unique  number.  Recoverable 
error  types  are  prefixed  with  "E0.n”  where  n is  the  error  number.  Fatal  errors 
have  the  prefix  "El.n".  The  errors  must  first  be  ordered  sequentially  ir.  the 
file  by  type  and  then  by  number. 
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SECTION  4 


PROGRAM  DOCUMENTATION 


A description  of  each  program  in  the  system  is  contained  on  the  follow 
ing  pages.  These  programs  are  one  of  two  types.  The  first  type  is  designe 
to  be  called  by  the  executive  and  therefore  the  calling  sequence  is  listed 
simply  as  one  or  more  entry  points.  These  routines  return  control  by 
executing  an  "RTS  R5"  instruction. 

The  second  program  type  consists  of  one  or  more  callable  subroutines. 
The  subroutine  calling  sequences  are  detailed  complete  with  calling  paramet 
and  descriptions  sufficient  for  the  programmer  to  call  upon  their  services. 

The  documentation  in  this  section  is  not  meant  to  describe  the  detaile 
methods  by  which  the  programs  accomplish  their  assigned  tasks.  It  is 
intended  to  be  a concise  reference  to  all  programs  contained  within  the 
system.  The  detailed  documentation  is  included  within  the  listings  which 
have  been  commented  extensively. 


Program  Name: 
Purpose : 


ARSLCT 


To  create  an  image  file  from  a specified  rectangular  area  within  an 
existing  image  file. 

Description: 

This  routine  creates  an  image  from  a user-specified  area  within  an 
existing  image.  Specification  of  the  area  is  obtained  through  the  keyboard 
via  the  subroutine  "SNGDEC".  All  of  the  available  free  core  buffer  area  is 
used  for  reading  the  existing  image,  extracting  the  specified  area  and 
writing  the  new  image  onto  the  disk. 

Subroutines  Called: 

E.ERR,  F.CRE,  F.PTR,  F.RET,  E.SHUT,  PARCOR,  RAD2AS , SI2DA  and  SNGDEC 
Calling  Sequence: 

Entry  is  from  the  Executive  at: 


ARSLCT 
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Fro gram  Name:  AS2RAD 


Purpose : 


To  pack  an  ASCII  character  string  into  RAD50. 


Description: 


An  ASCII  character  string  is  packed  into  RAD50.  This  mode  of  packing 
is  fully  described  in  the  "DOS  Monitor  Handbook".  Three  characters  are 
packed  at  a time  via  the  DOS  ".RADPK"  programmed  request.  An  error  return 
is  taken  if  any  illegal  characters  are  found. 

Subroutines  Called: 


RSTRE3  and  SAVF.EG 
Calling  Sequence: 


JSR 

R5.AS2RAD 

3R 

.+10. 

.WORD 

Address  of  ASCII  string 

. WORD 

Address  for  output  RAD50  string 

.WORD 

Number  of  ASCII  characters 

. WORD 

Address  of  illegal  character  error  routine 

General  regist 

ers  are  not  altered. 
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Program  Name:  BLDISP 

Purpose: 


To  retrieve  and  display  an  option  frame. 
description: 

This  routine  reads  the  specified  frame  into  core  and  displays  it  on  the 
Tektronix  graphics  terminal.  Since  the  frame  text  is  packed  into  RAD  50 
format,  it  must  be  converted  to  ASCII  prior  to  its  display.  This  unpacking 
is  accomplished  via  the  DOS  programmed  request  ".RADUP".  The  frame  itself 
is  read  from  the  disk  via  the  request  ".TRAN".  Registers  are  saved  upon 
entry  and  restored  upon  exit  to  prevent  interference  with  other  operations. 

A second  routine  is  available  which  simply  reads  the  frame  from  the 
disk  and  unpacks  the  text. 

Subroutines  Called: 


ALPHA,  CLEAR,  E.ERR,  G RHODE , HOME,  PLOT,  RSTREG,  SAVREG  and  TTYO 
Calling  Sequence: 

Read,  unpack  and  display  frame: 

JSR  RS, BLDISP 
Read  and  unpack  frame : 

JSR  R5 .UNPACK 

The  following  globals  are  set  by  EXEC: 

FRMNUM  - Set  to  the  number  of  the  desired  frame 

FRMADR  - The  address  of  the  first  block  of  the  "FRAMES. IPS" 

file 

FRMTBL  - Prior  to  the  first  call  to  one  of  the  routines  the 

first  word  of  this  buffer  must  be  set  to  a number 

other  than  that  of  the  frame  specified  in  FRMNUM. 

General  registers  are  not  altered. 


4-4 


Program  Name:  CALUSP  . , 

Purpose : 

t . - - 

To  load  and  execute  a user  program. 

Description : 

The  name  of  the  routine  is  obtained  from  the  user  via  "GETNAN" . The 
disk  is  then  searched  through  the  ".LOOK"  programmed  request  to  insure  the 
program's  existence.  The  file  specification  is  then  loaded  into  the  link 
and  file  blocks  (RUNLNK  and  RUNFIL)  within  EXEC.  Next  the  entry  point  is 
obtained  and  control  is  transferred  to  the  overlay  loading  routine  in  EXEC. 

Subroutines  Called: 

£ .ERR,  GETNAM,  LOADER  and  SNGDEC 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 

CALUSP 


Program  Name:  CB2DA 


To  convert  single  or  double  word  binary  numbers  to  decimal  ASCII. 
Inscription: 

Two  modes  of  parameter  passing  are  offered  for  complete  flexibility. 
They  can  be  passed  in  general  registers  or  in  parameter  lists.  For 
efficiency  this  routine  was  programmed  to  use  the  floating  point  processor. 
The  MODF  instruction  is  extremely  convenient,  especially  for  double 
precision  numbers. 

Subroutines  Called: 

RSTFPS , RSTREG , SAVFPS  and  RSTREG 

Calling  Sequence: 

Convert  double  word  to  ASCII: 

JSR  R5,DI2DAR 

R3  must  contain  high  order  part  of  number 

R4  must  contain  low  order  part  of  number 

R2  must  contain  the  address  of  a twelve-byte  buffer 
for  the  output  string 

or, 

JSR  R5.DI2DA 

BR  .+6 

.WORD  Address  of  double  word  number  (low  order  part  first) 

.WORD  Address  of  a twelve-byte  return  buffer. 

Convert  single  word  to  ASCII 
JSR  R5 , SI2DAR 

R4  must  contain  the  single  word  integer 

R2  must  contain  the  address  of  a twelve-byte  buffer 
for  the  output  string. 
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Program  Name : 


CB2DA  (Continued) 


or. 


JSR 

R5.SI2DA 

BR 

. +6 

.WORD 

Address  of  a 

single  word 

number 

. WORD 

Address  of  a 

twelve-byte 

return  buffer 

General  registers  are  not  altered. 


Program  Name : CHCUR 


Purpose : 


To  capture  the  position  of  the  Tektronix  cross  hair  cursor. 

Description: 

This  routine  turns  on  the  Tektronix  cross  hair  cursor  and  waits  for  the 
user  to  select  a position.  After  a position  is  selected  and  a character  is 
struck  this  program  accepts  the  input  byte  stream.  This  byte  stream  is 
then  converted  to  the  coordinate  values  which  are  placed  in  the  parameter 
list.  The  character  struck  by  the  user  is  also  returned. 


Subroutines 

Called: 

OUTCAR, 

RSTREG  and  SAVREG 

Calling  Sequ 

ence : 

JSR 

R 5, CHCUR 

BR 

.+8. 

.WORD 

Character  struck  on  keyboard 

.WORD 

X coordinate  value 

. WORD- 

Y coordinate  value. 

General  registers  are  not  altered. 
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Program  Name : CKTEXT 


Purpose : 


To  examine  file  header  text  and  allow  it  to  be  changec 


Description : 

The  file  is  obtained  via  F.RET.  The  header  text  is  then  printed  on  the 
graphics  display.  P.eplacement  text  is  then  accepted.  If  none  is  entered, 
the  file  is  closed  without  change. 

Subroutines  Called: 

F.CLOS,  F.RET,  TTYIN,  TTYC  and  TTYOUT 
Calling  Sequence: 

Entry  is  from  the  Executive  at: 

CKTEXT 


Program  Name : 


CLCV 


Purpose : 

To  remove  all  points  from  a binary  image  that  are  not  part  of  a closed 
curve . 

description: 

First  the  input  file  is  copied  to  the  output  file.  All  further  oper- 
ations are  then  performed  on  the  output  file.  The  neighborhood  of  each  pixel 
of  value  255  is  examined  to  determine  if  it  is  a part  of  a closed  curve.  If 
only  one  or  no  neighbors  are  255,  then  the  center  pixel  is  changed  to  zero. 

If  more  than  one  neighbor  is  255,  then  the  surround  is  checked  for  an  "edge, 
no  edge,  edge,  no  edge"  condition.  If  the  condition  exists,  the  point  is 
not  changed.  If  it  does  not  exist,  the  point  is  changed  to  zero. 

Subroutines  Called: 


E .ERR,  F.CRE,  F.P7R,  F.RET,  F.SHUT  and  RAD2AS 
Calling  Sequence: 


Entry  is  from  the  Executive  at: 


Program  Name:  CMPRES 


Purcose : 


To  compress  and  expand  matrices. 

Description : 

This  program,  contains  two  subroutines.  The  first  removes  row  and  column 
elements  of  either  a matrix  or  a vector  according  to  a calling  parameter  list. 
The  second  subroutine  inserts  zeroes  into  row  and  column  elements  of  either 
a matrix  or  vector,  also  according  to  a calling  parameter  list. 

Subroutines  Called: 


RSTREG  and  SA 

VREG 

Calling  Sequence: 

Expand  a matr 

ix  or  vector 

J SR 

R5 , EXPAND 

BR 

.+10. 

WORD 

Address  of 
at  which  tc 

address  of  list  of  row  and  column 
5 insert  zeroes 

r.'OTD 

Address  of 

address  of  matrix  or  vector 

t.jn  r~ 

* »»  _ . .U 

Address  of 

number  of  rows  in  matrix 

. WORD 

Address  of 

number  of  columns  in  matrix. 

Compress  a ma 

trix  or  vector: 

JSR 

R5, CMPRES 

BR 

.+10. 

. WORD 

Address  of 
to  remove 

address  of  list  of  row  and  column 

. WORD 

Address  of 

address  of  matrix  or  vector 

. WORD 

Address  of 

number  of  rows  in  matrix 

. WORD 

Address  of 

number  of  columns  in  matrix. 

General  registers  are  not  altered. 
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Program  Name:  COMBIM 


Purpose : 


of  t„o°iaagS“  the  aVe"*Se’  a SCaled  diff'™«  =-  the  absolute  difference 
Description: 

poirt^s  elec  ted  ***  COmi?ined  Point  by  P°int  according  to  the  entry 

bpr^?  ^rLieTdh,dS:s:ce^sfxddgfidding  •* 

255.  «U  of  which  is  divided  by  ?„o  ffil  SSm  S3f  P°intS  Pl“S 
absolute  value  of  the  difference  between  the  poiMs  “ S“Ply  th' 

Subroutines  Called: 

E.ERR,  F.CRE,  F.PTR,  F.RET,  F.SHUT,  PARCOR  and  RAD2AS 
Calling  Sequence: 

_ntry  is  from  the  Executive  at: 

A7E  - Average  images 

AVE+2  - Scaled  difference 

AVE+4  - Absolute  difference 


Program  Name:  COMPIL 


Purcose : 


To  compile  logical  and  arithmetic  statements  into  executable  machine 

code . 

Description : 

Two  entry  points  to  this  routine  are  available.  One  accepts  a logical 
expression  from  the  keyboard  and  compiles  it  into  machine  code.  This  was 
written  for  the  Boolean  logic  option.  The  second  entry  point  allows  several 
complete  statements  to  be  entered.  Three  statement  types  are  recognized. 

The  first  is  simply  an  arithmetic  assignment  statement,  the  second  is  like 
a FORTRAN  logical  IF  statement  and  the  third  is  a modification  of  the  IF 
called  an  IFGO.  This  is  simply  a logical  IF  that  when  satisfied,  the  arith- 
metic assignment  is  evaluated  and  all  following  statements  are  skipped. 

Both  entry  points  return  the  compiled  code  in  the  same  format:  the 

compiled  code,  a list  of  symbols  used  in  the  statements,  the  location  within 
the  code  of  the  values  represented  by  the  symbols  and  the  ASCII  string 


Subroutines  Called: 

AS2RAD,  E .ERR,  FSTFPS,  RSTREG , SAVFPS,  SAVREG,  TTYIN  and  TTYCL'T 
Calling  Sequence: 

To  compile  assignment,  IF  and  IFGO  statements: 

JSR  R5, COMPIL 


. WORD 


Address  of  a working  buffer 


Size  of  buffer  in  words. 


To  compile  a logical  expression  only: 


R5,CMPILB 


. WORD 


Address  of  a working  buffer 


. WORD 


Size  of  buffer  in  words. 


The  buffer  supplied  to  the  two  subroutines  should  be  made  as  large  as 
possible  to  prevent  overflow.  Upon  return  the  buffer  contains  the  following: 
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Program  Name : COMPIL  (Continued) 


Word  Definition 

1 Number  of  words  used  in  buffer. 

2 Address  of  compiled  code  relative  to  word  1. 

3 Address  of  symbol  table  relative  to  word  1. 

4 Address  for  symbol  values  relative  to  word  1. 

5+  Input  ASCII  character  string  terminated  with  a null. 

Symbol  Table 

Compiled  Code 

Symbol  Values 

SYMBOL  TABLE  FORMAT 
Word  Definition 

1 Number  of  symbols 

2 Status  word  for  symbol  1 

3,  4 RAD 50  pack  of  symbol  1 

5 Status  word  for  symbol  2 

6,  7 RAD50  pack  of  symbol  2 

Status  word  for  symbol  N 
RAD50  pack  of  symbol  N 
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Program  Name:  COMPIL  (Continued) 

STATUS  WORD  FCRXAT 

Bit  0 0 = Symbol  is  not  used  as  an  independent  variable 

1 = Symbol  is  used  as  an  independent  variable 
Bit  1 0 - Symbol  is  not  used  as  a dependent  variable 

1 = Symbol  is  used  as  a dependent  variable 
Bit  2 0 - Non-neighborhood  symbol 

1 = Neighborhood  symbol. 

The  compiled  code  is  called  as  follows: 

JSR  PC,(adr.  of  code) 

Prior  to  this  call,  the  values  of  all  variables  used  only  as  dependent 
variables  must  be  defined.  These  values  are  placed  in  the  buffer  area 
identified  by  word  4 of  the  return  buffer.  The  first  four  words  of  this 
area  are  reserved  for  special  subroutine  addresses.  The  first  three 
should  be  filled  with  the  entry  point  addresses  of  the  EXP,  LN  and  LOG 
routines  respectively.  The  fourth  is  a special  routine  that  retrieves 
image  points  whose  positions  are  relative  to  the  current  point.  This  routine 
must  be  provided  if  the  code  that  is  entered  references  it.  The  rcutir.e 
is  called  as  follows: 

JSR  R5,(adr.  of  neigh,  ref.  routine) 

.WORD  Image  number 

.WORD  Row  offset  from  current  position 

.WORD  Column  offset  from  current  position. 

(NOTE:  This  capability  is  not  currently  used  by  the  system.  It  is  planned 

for  use  in  future  work.) 

Following  the  four  special  addresses  appear  the  symbol  values  in  the 
order  of  appearance  within  the  symbol  table.  All  values  are  in  two  word 
floating  point.  Independent  variable  values  will  be  set  upon  return. 

When  "CNFILB"  is  called  the  logical  result  is  returned  in  Rl.  The 
returned  value  is  either  a 1 for  true  or  a 0 for  false. 


Frogram  Name:  CREFLT 


Purpose : 

To  generate  a filter  file. 

Description : 

This  routine  allows  a filter  to  he  generated  as  a function  of  the  row 
and  column  position  within  the  filter  array  or  as  a function  of  the 
Euclidean  distance  from  the  upper  left  corner  of  the  array.  The  function 
is  defined  by  the  user  at  the  keyboard.  The  routine  "CCMPIL"  is  called  to 
accept  this  input  and  to  compile  the  function  into  machine  code. 

Prior  to  generating  the  filter  file,  user  specified  cross  sections  of 
the  specified  filter  function  are  displayed  on  the  graphics  display.  These 
cross  sections  must  be  perpendicular  to  the  X-Y  plane. 

In  addition  to  allowing  a filter  file  to  be  generated,  the  specified 
function  can  be  stored  in  a separate  file.  This  allows  it  to  be  recalled 
in  the  future  for  further  filter  generation. 

Subroutines  Called: 

3LDISP , COMPIL,  ENABLR,  EXP,  E.ERR,  FLTEHT,  FPSQRT,  F.CLOS,  P.CRE, 
F.PTR,  F.RET,  GETCON,  LN,  LOG,  RAD2AS , SI2DA , SNGDEC , TTYIN,  TTYO  and 
TTYOUT 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 
CREFLT 
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Program  Name: 


CRESFS 


Purcose : 


To  create  and  edit  spectral  and  vector  set  files. 

Description : 

This  routine  performs  one  of  two  functions  based  upon  the  entry  po 
selected.  One  entry  point  deals  with  spectral  sets  and  the  other  with 
vector  sets.  Similar  operations  are  performed  by  both  routines.  File 
names  are  entered  at  the  keyboard  which  are  then  stored  m a file.  For 
spectral  file  sets,  class  symbols  and  data  reduction  factors  are  also 
accepted  and  stored. 

A second  operating  mode  can  be  entered  in  which  the  file  name  list 
can  be  edited  and/or  displayed. 


Subroutines  Called: 


BLDISP,  CLEAR,  DSAELR,  ENAEL.R,  E.ERP,  F.CLOS,  F C 
F . SHUT , GETh'AM , LMPRNT,  LFCLCS,  RAD 2 AS , RSTREG,  SAVREC- 
SN’GDEC , TTYIK,  TTYO  and  TTYOUT. 


, F . DEL , F.PTR, 
SI2DA,  SI2DAR, 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 

CRESFS  - spectral  set  file  operations 
C.RESFS+2  - vector  set  file  operations 
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Program  Name : CREVEC 


Purpose : 

To  create  vector  files  and  to  add  measurements  to  existing  vector  files. 


Tescrlption: 

This  routine  creates  two  types  of  vector  files.  A design  vector  file 
is  created  from  a spectral  set  in  which  regions  have  been  described.  In 
this  case  each  vector  can  be  identified  as  belonging  to  a particular  class. 

A test  vector  file  is  created  from  all  points  within  the  spectral  set.  Since 
the  vectors  are  not  created  on  the  basis  of  regions,  an  identifying  class 
symbol  cannot  be  assigned. 

Only  spatial  measurements  can  be  added  to  an  existing  vector  file. 

These  measurements  consist  of  basic  statistics  computed  over  neighborhoods 
of  each  point. 

Subroutines  Called: 


3EGFND , CFREQ,  CMEAN,  CSDEV,  DI2DAR,  E .ERR,  F.CLOS,  F.CRE,  F.DEL, 
F.PTR,  F.RET,  F.RNM,  F.SHUT,  FINDPT,  GHIGH,  GLOW,  GMEAN , GMEDN,  GRANGE, 
GSEEV,  RAD2AS , SI2DA,  SMINIT,  SNGDEC , SNGLFT,  TTYIN,  TTYO  and  TTYOUT 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 

CREVEC  - Create  test  vector  file 
CREVEC+2  - Create  design  vector  file. 
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Program  Name : CRLOG 


Purpose : 

To  create  and  initialize  logic  tree  files. 

Description: 

This  routine  creates  a logic  tree  file.  The  directory,  the  logic  tree 
and  the  class  symbol  pages  are  all  initialized  according  to 
vector  set.  The  overall  result  is  a logic  tree  consisting  o 
senior  node.  All  class  symbols  are  assigned  to  that  node. 

Subroutines  Called: 


E.ERR,  F.CRE,  F.CLOS,  F.PTR,  RSTREG  and  SAVP.EG 
Calling  Sequence: 

JSR  R5 ,CRLCG 

3R  . +8 . 

.WORD  Address  of  the  address  cf  a working  buffer 

.WORD  Address  of  the  size  of  the  buffer 

.WORD  Address  of  a four  word  file  specification 

(Device  (RAD50),  unit  and  file  name  (RATfl8)) 
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Program  Name: 


CTFILE 


Purpose : 

To  create  an  input  file  from  values  entered  via  the  keyboard. 
Cescription: 

The  values  for  each  pixel  within  the  image  are  obtained  through  the 
keyboard.  The  values  are  then  stored  in  a disk  file. 

Subroutines  Called: 

F.CRE,  F.PTR,  F . SHUT , SI2DA  and  SNGDEC 
Calling  Sequence: 

Entry  is  from  the  Executive  at: 

CTFILE 
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Program  Mame : DEC IMG 


Purrose : 

To  create  a thematic  map  from  a classified  set  of  vectors. 


Description: 

A thematic  map  is  created  to  present  the  classification  of  vectors  in 
an  image  format.  The  first  step  in  the  process  is  to  insure  that  each 
terminal  node  in  the  tree  is  associated  with  only  one  class.  Also,  the 
vector  file  must  contain  positional  information  with  respect  to  rows  and 
columns.  The  classification  of  each  vector  is  determined  and  a grey  level 
is  assigned  to  the  pixel  value  associated  with  the  position  of  the  vector. 
Drey  level  assignments  are  made  by  the  user  on  the  basis  of  class. 


Subroutines  Called: 


•>  T^P 


AR, 

DETh'OD , GETSYM,  L.\’ 


E .ERR,  E.CRES,  F.PTR,  F.RET,  F . RETS , F.SHUT, 
RNT , LPCLOS , OPLF , RAD2AS , SI2DAR  and  SNGDEC 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 


DECIMG 
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Program  Name  i DELEiE 
Purpose : 

To  delete  a file  from  a disk  peripheral. 


rescript  ion : 

T.  file  specification  is  obtained  from  the  user.  The  file  is  then 
The  file  speci-i  contained  in  the  program  to  alio. 

^ assa/ss*  ;iie  “• 

extension  is  used  if  none  is  entered. 

Subroutines  Called: 

E . ERR , F . DEE  and  GETIIAM 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 


DELETE 
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Program  fJame  : EXEC  (Continued) 


Program  Name : DENHST 


Purpose : 

To  compute  and  display  histograms  of  images  and  regions  within  images. 
description : 

The  histograms  computed  are  based  upon  the  density  values  within  the 
image  and  the  maximum,  minimum  and  average  difference  between  each  point 
and  its  eight  neighbors.  These  are  computed  for  complete  images  and  for 
specified  regions  within  images.  The  routine  "FINDPT"  is  used  to  determine 
which  points  are  within  the  regions.  After  the  histogram  is  computed,  the 
routine  "HISPLT"  is  called  to  display  it  on  the  graphics  display. 

After  the  histogram  is  displayed  several  options  are  available.  Most 
of  these  deal  with  such  things  as  zooms,  change  tick  mark  spacing,  etc. 

One  ODtion  determines  the  percentage  of  the  total  number  of  points  that 
lie  within  a user  specified  range.  Another  allows  a cumulative  histogram 
to  be  displayed. 

In  addition  to  above  options,  a density  profile  of  any  given  row  can  be 
displayed  in  histogram  format.  Display  options  similar  to  those  discussed 
above  are  also  available  for  this  function. 

Subroutines  Called: 

ALPHA,  3EGFND,  BLDISP,  CLEAR,  DBLDEC , DI2DA , DI2DAR,  DSABLR,  ENABLR, 

E . ERR,  FPASCF , F.CLOS,  F.PTR,  F.RET,  FINDPT,  GRMODE,  HISPLT,  HOME,  OPTION, 
PLOT,  RA.D2AS , RSTREG , SAVREG,  SI2DA,  SI2DAR,  SNGDEC , TTYO  and  TTYOUT 


Entry  is  from  the  Executive  at: 

BEGIN  - Calculate  image  histograms 
BEGIN+2  - Calculate  region  histograms 
BEGIN+4  - Display  single  line  density  profile. 


Program  Name : DICOMD 

Purpose : 

To  record  images  on  film  via  the  Dicomed  Image  Recorder. 

Description : 

A user  specified  image  is  retrieved  and  printed  on  the  Dicomed  Image 
Recorder.  The  recorder  resolution,  polarity  and  transfer  function  are  set 
by  this  routine  according  to  the  user's  specification.  A blow-up  factor 
is  also  accepted.  The  blow-up  is  accomplished  by  replicating  both  rows 
and  columns  prior  to  transfer  to  the  recorder. 

Subroutines  Called: 


E.ERR,  FR3 , FRI,  FRW,  F.CLOS,  F.CRE,  F.PTR,  F.RET,  F.SHUT,  RSTREG, 
SAVREG,  SNGDEC  and  TTYCL’T 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 
DICOMD 


Program  Name: 


DIFFAC 


Purpose : 

To  create  a scaled,  weighted  combination  of  two  images. 
description : 

Each  point  in  the  two  input  images  is  multiplied  by  a factor.  Th 
combination  is  then  formed  according  to  the  signs  of  the  weights.  The 
result  is  then  scaled  over  the  range  of  zero  to  255. 

Subroutines  Called: 

E . ERR,  F.CRE,  F.PTR,  F.RET,  F.SHUT,  PARCOR,  RAD2AS , SI2DA,  SI2DAR 
SNGDEC  and  TTYOUT 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 

DIFFAC 
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Frogram  Name : DIRCTY 

Purpose : 

To  print  directories  of  disks  on  the  line  printer  or  graphics  display. 
Description : 

The  directory  is  read  into  core  from  the  specified  disk  and  is  sorted 
first  by  extension  and  then  alphabetically.  If  a short  directory  is 
requested,  it  is  then  printed  on  the  specified  device.  If  a long  directory 
is  desired,  the  header  block  of  each  file  is  read  and  then  the  file  size 
and  header  text  are  extracted  for  inclusion  in  the  listing. 

Subroutines  Called: 

BLDISP,  CLEAR,  DSABLR,  EKABLR,  E.ERR,  F.INIT,  F.RLSE,  GETDEV,  GETMA” , 
LNPRNT,  LPCLOS , RAD2AS,  SI2DA , SNGDEC , TTY IN,  TTYO  and  TTYOUT 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 

DIRCTY  - List  long  directory 

DIRCTY+2  - List  short  directory 
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Program  Name : ELCHNG 


Purpose : 

3** 

To  replace  specified  density  values  or  ranges  of  values  with  new  values. 
Description : 

The  type  of  operation,  individual  values  or  ranges,  is  determined  by 
the  entry  point.  In  either  case,  the  values  and  ranges  along  with  the 
replacement  values  are  specified  by  the  user.  A table  of  256  entries  is 
then  created  which  defines  a transfer  function  over  the  grey  value  range 
of  0 to  255.  This  table,  along  with  the  input  and  output  files,  is  passed 
to  TRNFTN  for  processing. 

Subroutines  Called: 

E.ERR,  F.CRE,  F.PTR,  F.RET,  F.SHUT,  RAD2AS , SNGDEC , TRNFTN  and  TTYOUT 
Calling  Sequence: 

Entry  is  from  the  Executive  at: 

ELCHNG  - Change  individual  elements 
ELCHNG+2  - Change  ranges  of  elements. 


Program  Name:  EVALBL 


Purpose : 

To  apply  Boolean  logic  to  a vector  set. 

Description : 

This  routine  is  called  by  EVALDR  to  apply  3oolean  logic  which  resides 
at  a given  node  in  the  logic  tree.  The  logic  file  is  opened,  the  logic  is 
extracted  and  the  file  is  closed.  The  vector  set  is  then  opened  and  the  logic 
is  applied  to  each  vector.  The  vector  set  is  then  closed  upon  completion. 

Subroutine  Calls: 

CLLF,  CLOVEC,  EXP,  GETVEC , GTLF , L1I , LOG,  OPLF,  OPNVEC,  PSTFPS,  P.STFEG, 
SAVFFS , SAVREG 

Calling  Sequence: 

JSR  R5, EVALBL 

Prior  to  entry,  the  first  nine  words  of  the  "FRECOR"  buffer  must  be  set 

to : 


Word 


Description 


0 

1 

2 

3,4 

C 

6 

7,9 

9 


Logic  node  number 
Logic  file  device  (P.AD50) 

Logic  file  unit  number 
Logic  file  name  (RAD50 ) 

Vector  file  device  (RAD5C) 

Vector  file  unit  number 
Vector  file  name  (RAD5C) 

Node  number  at  which  logic  evaluation  began 
(used  only  by  EVALDR) 


These  values  are  not  modified. 
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To  control  the  overall  logic  evaluation  operations. 


inscription : 

This  routine  accesses  the  logic  file  to  determine  which  logic  evaluation 
routine  should  be  called  at  each  node  in  the  tree.  That  routine  is  then 
called. 

Three  modes  of  operation  exist.  The  first  mode  evaluates  the  logic  at 
the  current  node  only.  The  second  mode  evaluates  logic  at  the  current  node 
and  all  nodes  below  the  current  node.  The  last  mode  evaluates  all  logic  in 
the  tree  beginning  at  the  senior  node. 

Subroutine  Calls: 

CLLF,  CLLOGF,  EVALEL,  EVALFP,  E .ERR,  GETNAM,  GETNOD,  GTLOGF,  OPLF  and 
OPLOGF 


Calling  Sequence: 


Entry  is  from  the  Executive  at: 


EVALDR 


Program  Name : EVALFP 


Puroose : 


To  apply  Fisher  pairwise  logic  to  a vector  set. 

Description: 

This  routine  is  called  by  EVALDR  to  apply  Fisher  logic  which  resides  at 
a given  node  in  the  logic  tree.  The  logic  file  is  opened,  the  logic  is 
extracted  and  the  file  is  closed.  The  vector  set  is  then  opened  and  the  logic 
is  applied  to  each  vector.  The  vector  set  is  then  closed  upon  completion. 

Subroutine  Calls: 

CLLF,  CLOVEC , GETVEC , GTLF , OPLF,  OPNVEC 


Calling  Sequence: 


JSR  R5, EVALFP 

Prior  to  entry,  the  first  nine  words  of  the  "FRECOR"  buffer  must  be  set 
to: 


Word 


Description 


0 

1 

2 

3,4 

5 

6 

7,8 


Logic  node  number 
Logic  file  device  (RAD50) 

Logic  file  unit  number 
Logic  file  name  (RAD50) 

Vector  file  device  (RAD50) 

Vector  file  unit  number 
Vector  file  name  (RAD50) 

Node  number  at  which  logic  evaluation  began 
(used  only  by  EVALDR) 


These  values  are  not  modified. 


Program  N’ame:  EXEC 


Purpose : 

To  control  the  execution  of  all  functions  in  the  image  processing  system. 
Inscription: 

This  routine  is  the  executive  control  program  for  the  image  processing 
system.  It  accepts  user  frame  selections  and  determines  the  appropriate 
action  to  be  taken.  This  could  be  to  display  a new  frame  or  to  retrieve  and 
execute  an  option  overlay. 

The  file  system  programs  (FILE1,  FILE2,  FILE3  and  FILE4)  are  overlays 
to  this  program.  Therefore,  the  calls  to  these  routines  must  be  made  through 
EXEC  to  activate  the  autoload  software  of  DOS.  A portion  of  this  autoload 
software  has  been  replaced  by  a portion  of  EXEC.  This  .change  allows  overlays 
from  the  core  resident  programs'  file  and  from  the  option  overlay  files  without 

confusion.  This  type  of  operation  is  not  allowed  by  the  DOS  modules  that  were 
replaced . 

Other  functions,  such  as  the  automatic  log  and  the  error  reporting 
routines  are  also  contained  within  EXEC.  One  section  of  code  is  exclusively 
used  for  initialization  functions  and  is  overlayed  by  the  free  core  buffer 
following  initialization.  This  area  is  defined  to  be  in  the  .PSECT  region 
named  "FRECOR".  This  .PSECT  is  used  to  allow  the  size  of  the  FP.ECOR  buffer 
to  be  expanded  at  link  time.  A second  .PSECT  region  named  "FRESIZ"  is 
included  to  establish  the  end  of  the  FRECOR  buffer.  The  reader  will  note 
that  "FRESIZ"  will  follow  "FRECOR"  in  core  due  to  the  alphabetization 
performed  by  the  linker.  Since  the  label  "ENDCCR"  is  defined  within  "FRESIZ" 
it  will  then  represent  the  true  end  of  the  "FRECCR"  buffer. 

Subroutines  Called: 

ALPHA,  BLDISP,  C0NV10,  F.C,  F.C$,  F.CDOS,  F.CH,  F.CL,  F.D,  F.E , F.I, 

F.O,  F.P,  F.R,  F.R$,  F.RL,  F.RN,  F.S,  RSTREG , SAVREG,  TTYGRF , TTYIN,  TTYO , 
TTYOUT  and  UNPACK 

Calling  Sequences: 

The  main  entry  point  where  control  is  transferred  by  DOS  is  at: 

E . EXEC 

The  optional  parameter  which  appears  in  the  four  following  create  and 
retrieve  calling  sequences  provides  the  capability  for  an  alternate  return 
should  the  user  respond  with  nothing  other  than  a carriage  return.  If  this 
parameter  is  not  specified,  an  error  will  be  reported  for  such  a condition. 
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Program  Kane : EXEC  (Continued)  i 


Create  Files 

JSR 

R5,F.CRE$ 

BP. 

End  of  Param  List 

. WORD 

Adr.  of  File  Request  31ock 

• WORD 

Adr.  of  Alternate  Return  (Optional) 

NOTE:  The  buffer 

specified  in  the  request  block  is  not 

Create  and  Open  F. 

Lies 

JSR 

R5.F.CRE 

BR 

End  of  Param  List 

. WORD 

Adr.  of  File  Request  Block 

.WORD 

Adr.  of  Alternate  Return  (Optional) 

Retrieve  Files 

JSR 

R5 ,F . RETS 

BR 

End  of  Param  List 

. WORD 

Adr.  of  File  Request  Block 

. WORD 

Adr.  of  Alternate  Return  (Optional) 

NOTE : The  buffer 

specified  in  the  request  block  is  not 

Retrieve  and  Open 

Files 

JSR 

R5.F.RET 

EP. 

End  of  Param  List 

.WORD 

Adr.  of  File  Request  Block 

.WORD 

Adr.  of  Alternate  Return  (Optional) 
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Program  Name:  EXEC  (Continued) 

Check  for  File  Existence 


JSR 

R5.F.CHK 

3R 

.+6 

• WORD 

Adr.  of  Request  Block 

. WORD 

Return  Adr.  if  File  is  Nonexistent 

NOTE : 

The  buffer 

specified  in  the  request  block  is  not  used  for  this  call. 

Access 

a Record  or 

Group  of  Contiguous  Records 

JSR 

R5 ,F . PTR 

3R 

. +6 

.WORD 

Adr.  of  File  Request  Blk. 

.WORD 

Return  Address  if  Record  Nonexistent 

Delete 

a F ile 

JSR 

R5.F.DEL 

BR 

.+6 

.WORD 

Adr.  of  a Buffer  Containing,  In  Order,  The  Link  (5  WDS.) 
and  the  File  (7  WDS.)  Blocks  Describing  the  Desired  File 

.WORD 

Return  Adr.  if  File  is  Nonexistent 

Rename 

a File 

JSR 

R5.F.RNM 

* 

3R 

.+10 

.WORD 

Adr.  of  a Buffer  Containing,  In  Order,  a Link  Block 
(5  WDS.),  a File  Block  (7  WDS.)  Containing  the  Current 
Name  and  a File  Block  Containing  the  New  Name 

.WORD 

Return  Adr.  if  the  File  is  Non-Existent 

* 

.WORD 

Return  Adr.  if  a Dup.  File  Name  is  Found. 
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Program  Name:  EXEC  (Continued) 

Extend  a File 


JSR 

R5,F.EXT 

BR 

. +6 

. WORD 

Request  Blk.  Adr. 

. WORD 

Adr.  of  Location  Containing  Size  of  Extension  in  256  WD  Elks 
the  File  must  be  in  a Closed  State 

Close  a File 

JSR 

R5,F.CL0S 

BR 

. +4 

. WORD 

Adr.  of  File  Request  Block 

Close  All  Open  F 

'iles 

JSR 

R5 ,F . SHUT 

Initialize  a Dat 

aset  for  Direct  DCS  Access 

JSR 

R5,F. INIT 

BR 

.+4 

.WORD 

Link  Blk.  Adr. 

Open  a File  for 

Direct  DOS  Access 

JSR 

R5 ,F . OPEN 

BR 

. +6 

. WORD 

Link  Elk.  Adr. 

. WORD 

File  Elk.  Adr. 
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Program  Name:  EXEC  (Continued) 

Close  a File  Which  Was  Open  for  Direct  DOS  Access 


JSR  R5,P.CLSE 

5R  .+4 

.WORD  Link  Blk.  Adr. 

Release  a Dataset  Which  Was  Initialized  for  Direct  DOS  Access 
JSR  R5,F.RLSE 

3R  .+4 

.WORD  Adr.  of  Link  Blk. 


Request  Block  Format. 

•WORD  Adr.  of  Char.  String  for  Requesting  File  Name 

.WORD  File  Name  1st  WD. 

.WORD  File  Name  2nd  WD. 

.WORD  File  Extension 

•WORD  Device  Name  in  RAD50 

.BYTE  Unit  No. 

.BYTE  File  Access 

Bit  0:  0 - Fixed  Length  Record 

1 - Variable  Length  Record  (Not  Implemented) 

Bit  1:  0 - Contiguous  File 

1 - Linked  File  (Not  Implemented) 

Bit  2:  0 - No  Read 

1 - Read  File 

Bit  3:  0 - No  Write 

1 - Write  Into  File 

.WORD  Adr.  of  File  Operations  Buffer 

.WORD  Buffer  Size  (BYTES) 
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Program  Name : EXEC  (Continued) 


.WORD 

Number  of  Records 

■ WORD 

Record  Length 

.WCRD 

No.  of  Consecutive  Rec.  Needed  in  Core  Simultaneously 

■ WORD 

Record  Number  Requested 

The  Error  Processing  Routine  is  Called  as  Follows: 

JSR 

R5.E.ERR 

BR 

. +4 

.BYTE 

Error  Number 

. BYTE 

Error  Type 

An 

in  the  . 
control 

overlay  can  be  loaded  by  setting  the  appropriate  file  identification 
RUN  LINK  and  file  blocks  (RUNLINK  and  RUNFIL)  and  transferring 
to  "LOADER". 

The 

autoload 

following 
facility . 

three  entry  points  are  for  routines  that  support  the  overlay 

$RDSEG  - 

Read  Overlay 

SSAVAL  - 

Save  and  Restore  Registers 

$$WAIT  - 

Initialize  and  Check  Overlay  Status 

The 

current 

following 
overlay  to 

entry  point  when  taken  causes  the  stack  to  be  reset  and  the 
be  removed  from  memory.  Control  is  then  transferred  to  the 

Executive . 

RESTRT 


4-37 


Program  Name:  EXP 


Purpose : 

To  compute  the  exponential  value  for  a given  power. 

Description : 

This  routine  raises  "e"  to  the  power  indicated  by  the  calling  argument. 
The  computational  method  is  discussed  in  Hart  [1]  . 

Subroutines  Called: 

(See  calling  description.) 

Calling  Sequence: 

JSR  R5,EXP 

The  argument  is  expected  to  be  supplied  in  AC0.  The  result  is  also 
returned  in  AC0. 

Two  error  returns  must  be  provided  which  are  called  as  follows: 

Positive  exponent  too  large: 

JSR  R5 ,EXPBIG 

Negative  exponent  too  large: 

JSR  R5.EXPSML 

If  either  of  these  error  routines  returns  via  an  "RTS  PC",  an  unknown 
value  will  be  returned  in  AC0. 

General  and  floating  point  registers  are  modified. 


Program  Name : FILE1 

Purpose : 


To  create  and  retrieve  data  files. 


Description : 


This  program, 
entry  points  exist 
One  entry  point  in 
without  opening  it 
access  as  well.  A 
file.  If  it  is  not 


which  is  an  overlay  to  EXEC,  has  five  entry  points, 
for  creating  files  and  two  exist  for  retrieving  files 
each  case  allows  the  file  to  be  created  or  retrieved 
for  access.  The  other  entry  point  opens  the  file  for 
fifth  entry  point  simply  checks  for  the  existence  of 
found,  an  alternate  return  is  taken. 


a 


Piles  that  are  opened  have  an  associated  buffer.  A header  in  this 
buffer  is  established  for  accessing  the  file  on  disk  via  the  FILE2  overlay. 
DCS  link,  file  name  and  tran  blocks  are  established  within  this  header, 
along  with  parameters  which  describe  the  current  contents  of  the  buffer's 
data  area. 


each  f 


list  is  maintained  within  EXEC  of  all  open  files, 
le  is  opened,  the  address  of  its  request  block  is 


Ls  list. 


Therefore,  as 
r.serted  into 


All  file  operations  are  performed  within  the  DCS  file  structure.  The 
DOS  programmed  requests  are  used  for  accomplishing  the  desired  tasks. 

Subroutines  Called: 


GETNAX , RE 


iAVP.EG  at 


""•V' 


Calling  Sequence: 


Since  the  routines  contained  within  this  program,  are  accessed  as  an 
overlay  through  the  executive,  detailed  calling  sequences  are  provided 
under  EXEC.  EXEC  transfers  control  to  the  following  entry  points  via  a 
"JKP"  statement : 


F.CS  - 

Create  a file 

F.C 

Create  and  open  a file 

>T1 

*pO 

</> 

1 

Retrieve  a file 

F.R 

Retrieve  and  open  a file 

F.CH  - 

Check  for  file  existence 
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Program  Name:  FILE2 


Purpose : 

To  access  data  within  a file. 

-ascription: 



This  routine  accesses  data  within  files  that  are  opened  by  the  routines 
in  the  FILE1  overlay.  This  routine  is  also  an  overlay  to  the  EXEC  program. 

When  a request  is  made  for  a record  or  group  of  contiguous  records, 
the  associated  buffer  header  is  examined  to  determine  if  the  data  has  been 
loaded  into  core  by  a previous  operation.  If  it  is  in  core,  it's  address 
is  simply  returned  to  the  calling  program.  If  not,  the  file  access  mode 
is  checked  to  determine  what  operations  are  to  be  performed.  If  the  access 
is  "read  only",  the  requested  data  is  read  into  core.  If  the  access  is  "write 
only",  the  data  is  written  onto  the  disk  and  the  position  for  the  desired 
record(s)  is  established  in  core.  If  the  access  is  "read/write" , the 
current  buffer  contents  are  written  onto  the  disk  and  the  desired  record(s) 
are  then  read  into  core.  In  all  cases  where  data  is  read  into  core,  an 
amount  of  the  data  equal  to  the  size  of  the  buffer  is  read  into  core.  This 
is  done  in  anticipation  of  future  requests  for  the  next  records  in  sequence. 
This  reduces  overall  data  transfer  time. 

Subroutines  Called: 


E.ERR 

Calling  Sequence: 

Since  this  routine  is  accessed  as  an  overlay  through  the  executive, 
a detailed  calling  sequence  is  provided  under  EXEC.  EXEC  transfers  control 
to  the  entry  point  "F.P"  via  a "JMP"  statement. 


Program  Name:  FILE 3 


Purpose : 

To  delete,  rename  and  close  files  and  to  initialize,  open,  close  and 
release  datasets. 

Description : 

The  delete  and  rename  operations  expect  DOS  link  and  file  name  blocks 
to  be  prepared  as  required  by  the  ".DELET"  and  ".RENAM"  programmed  requests. 
These  requests  are  then  used  to  perform  the  desired  function. 

Two  entry  points  are  available  for  closing  files.  The  first  closes 
individual  files  and  the  second  closes  all  files  that  are  currently  open. 

In  either  case,  the  associated  file  request  block  addresses  are  removed 
from  the  open  file  list  within  EXEC. 

To  establish  control  over  datasets  (as  defined  under  DCS)  that  have 
been  initialized  and/or  opened,  routines  are  included  herein  to  maintain 
lists  of  such  datasets  within  EXEC.  This,  for  example,  prevents  an 
application  overlay  from  initiating  a dataset  but  not  releasing  it  due  to 
a premature  termination  of  the  execution  of  the  overlay.  These  routines 
provide  the  initialize,  open,  close  and  release  dataset  functions. 

Subroutines  Called: 

E.ERR,  RSTREG  and  SAVREG 

Calling  Sequence: 

Since  the  routines  contained  within  this  program  are  accessed  as  ar. 
overlay  through  the  executive,  detailed  calling  sequences  are  provided 
under  EXEC.  EXEC  transfers  control  to  the  following  entry  points  via  a 
"JMF"  statement: 

F.D  - Delete  a file 

F.RN  - Rename  a file 

F.CL  - Close  a file 

F.S  - Close  all  op'n  files 

F.I  - Initialize  a dataset 

F.O  - Open  a dataset 

F.CDOS  - Close  a dataset 

F.P.L  ; - Release  a dataset. 
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I 


Frogram  Name:  FILE4 


Puroose : 


To  extend  the  length  of  a specified  file. 
description: 

The  file  is  retrieved  and  its  current  size  is  obtained.  The  requested 
extension  is  then  added  to  this  size  and  a new  file  is  created  under  the 
name  of  "IPS.TMP".  Any  previous  files  existing  under  this  name  are  deleted. 
The  old  file  is  copied  into  the  new  file,  the  old  file  is  deleted  and  the 
new  file  is  renamed  to  that  of  the  old  file. 

Subroutines  Called: 

E . ERR,  RSTREG  and  SAVREG 

Calling  Sequence: 

Since  this  routine  is  accessed  as  an  overlay  through  the  executive, 
a detailed  calling  sequence  is  provided  under  EXEC.  EXEC  transfers 
control  to  the  entry  point  "F.E"  via  a "JMP"  statement. 
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Program  Name : FILL 


Purpose : 


To  restore  breaks  in  lines  in  a binary  image. 

Pescription : 

This  routine  scans  a binary  input  image  for  non-edge  points  (0  grey 
value)  whose  eight  surrounding  points  meet  an  "edge,  non-edge,  edge,  non- 
edge” condition.  When  this  condition  is  discovered  the  point  is  replaced 
with  a value  of  255.  The  result  is  non-connected  edge  points  separated 
by  one  pixel  are  connected.  Two  different  procedures  are  followed 
depending  upon  which  entry  point  is  selected.  Either  the  operation  is 
performed  on  only  data  appearing  in  the  input  image  or  on  the  current 
state  of  the  union  of  the  input  and  output  images. 

Subroutines  Called: 

E .ERR,  F.CRE,  F.PTR,  F.RET,  F.SHUT  and  RAD2AS 

Calling  Sequence: 

Entry  if  from  the  Executive  at: 

START  Regular  fill  in 

START  +2  Adaptive  fill  in 


Program  Name:  FINDPT 


Purpose : 


To  determine  the  interior  points  of  a region  defined  by  a region  file. 
Description : 

t - . 

This  program  determines  the  points  interior  to  and  on  a region  boundary. 

A boundary,  as  opposed  to  being  a line  of  zero  width,  is  actually  one  or 
more  pixels  wide  depending  upon  the  orientation  of  the  line  within  the 
array.  As  a result,  this  "thick"  boundary  greatly  complicates  the  task  of 
finding  the  region  points. 

The  problem  is  attacked  by  taking  one  row  at  a time  and  determining 
its  intersection  with  the  boundary  lines.  These  are  called  intersection 
intervals.  The  beginning  of  a row  is  assumed  to  be  an  exterior  point  and 
is  therefore  a point  of  reference.  When  the  row  reaches  an  intersection 
interval  the  points  then  are  considered  interior  points.  After  the  interval 
is  passed,  the  status  of  the  points  depends  on  the  interval  characteristic. 

If  the  intersection  interval  is  not  at  the  end  of  a boundary  line  segment, 
then  as  the  row  passes  through  the  interval,  it  goes  from  outside  the  region 
to  inside  or  vice-versa.  Therefore  the  interval  is  an  "in-out"  or  "change" 
interval. 

The  intervals  at  the  vertices  of  the  line  segments  are  somewhat  more 
complicated.  In  this  case,  the  characteristic  of  the  interval  is  "change" 
if  the  boundary  lines  meeting  at  the  vertice  approach  it  from  opposite 
sides  of  the  row  in  question.  If  they  approach  the  vertice  from  the  same 
side,  the  interval  is  a "no  change"  interval.  This  means  that  points  on 
the  interval  are  within  the  region  but  points  on  either  side  of  it  are 
either  both  inside  or  both  outside  the  region. 

Horizontal  lines  in  the  boundary  are  essentially  one  long  intersection 
interval.  Such  an  interval's  characteristic  is  determined  by  the  lines 
which  meet  its  end  points.  A rule  similar  to  the  vertice  rule  above  is 
followed.  If  the  lines  at  each  end  approach  from  opposite  sides  of  the 
row  its  characteristic  is  "change".  If  they  approach  from  the  same  side  it 
is  "no  change".  Successive  horizontal  lines  are  combined  into  one  long 
interval. 

For  each  row  that  crosses  the  region,  the  above  procedure  is  followed 
to  determine  the  interior  points.  One  subroutine  (BEGFND)  must  be  called 
to  initialize  the  operation.  Successive  calls  to  FINDPT  then  return  the 
row  and  oolumn  values  found  within  the  region.  Each  call  returns  one  point. 

Another  subroutine  (SNGLPT)  determines  if  a given  point  is  in  the 
region.  The  procedure  for  making  this  determination  is  the  same  as  the  above. 


Program  Name:  FINDPT  (Continued) 


Subroutines  Called: 


E.ERR,  F.CLOS,  F.PTR,  F.RET,  RSTFPS,  RSTP.EG , SAVFPS  and  SAVF.EG 
Calling  Sequence: 

To  retrieve  the  region  file  and  initialize  the  working  buffer  for  use 
by  FINDPT  and  St.'GLPT : 

JSR  R5.BEGFND 


.WORE  Address  of  the  request  block  for  the  region  file. 

.WORD  Address  of  an  alternate  return  to  be  taken  when  the 

user  responds  to  the  request  for  a region  file  name 
with  only  a carriage  return . 


Upon  return  from  EEGFND  the  buffer  specified  in  the  request  block  is 
still  in  use  even  though  the  region  file  has  been  closed.  This  buffer  is 
used  until  all  calls  to  FINDPT  and  SNGLPT  have  been  completed  for  that 
region. 

To  obtain  the  coordinate  of  the  next  point  found  within  the  region; 

JSR  R5, FINDPT 


.WORD  Address  of  the  request  block  for  the  desired  region 

.WORD  Address  of  an  alternate  return  when  there  are  no 
further  points  remaining  in  the  region. 

The  coordinate  values  are  returned  on  the  stack  with  the  row  on  tot 
followed  by  the  column. 

To  determine  if  a particular  point  is  within  the  region: 

JSR  P.5,  SNGLPT 


Address  of  the  request  block  for  the  desired  region 


Row  coordinate  value 


Column  coordinate  value 
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Program  Name : FISODF 


thresholds . 


. es erupt  ion : 


This  routine  computes  the  above  mentioned  values  for  a giver,  class 
pair.  The  records  in  the  mear.-covar iance  file  (MCFILE.MC)  associated  v/ith 
the  two  classes  are  passed  as  parameters.  One  class  pair  is  treated  per 


Subroutines  Called: 

rvpcr-c  rvr;v-  r rsc  rocrt"  r (1FTTV  tvvva—  T T"^rr  M-,nT 

RSTREG , SAVREG  and  SETIXC 


Frior  to  calling  "FISHER"  the  following  call  must  be  made: 

JSR  R5,SETFIS 

this  routine  expects  the  following  globals  to  be  provided: 

BOTCOR  - Address  of  the  beginning  of  a working  buffer 
TOPCOR  - Address  of  the  end  of  the  working  buffer. 

The  Fisher  values  are  calculated  by  the  following  call: 

JSR  R5, FISHER 

This  routine  expects  the  following  globals  to  be  provided: 

MCELK  - Address  of  request  block  for  file  MCFILE.MC 

MCF.EC  - Record  number  parameter  in  request  block  for  MCFILE.MC 

KVEC  - Buffer  containing  the  measurements  from  which  to  create 

the  logic.  The  first  word  is  the  number  of  measurements 
and  each  viord  thereafter  contains  a measurement  number. 

PAGEA  - Fecord  number  in  MCFILE.MC  corresponding  to  the  first 
class . 


PAGEB  - Record  number  in  MCFILE.MC  corresponding  to  the  second 
class . 
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Program  Name : FISODP  (Continued) 

VECDIM  - Dimension  of  the  vectors. 

Upon  return,  the  computed  values  are  found  at  the  addresses  given  in 
the  following  global  locations: 

DP  - Address  of  discriminant  plane  vector 

FISH  - Address  of  Fisher  vector 

THRESH  - Address  of  five  thresholds. 

All  values  are  in  single  precision  floating  point.  See  documentation  of 
logic  tree  file  (Appendix  E)  for  the  formats  of  the  return  values. 

General  Registers  are  not  modified. 


>> 


Program  Name : FLTMUL 


Purpose : 

To  form  the  product  between  a filter  file  and  a file  of  another  type. 
description : 

The  product  between  the  files  is  formed  on  a point-by-point  basis. 

The  second  file  can  have  byte,  integer,  double  integer  or  floating  point 
values.  However,  it  must  be  an  array  type  of  file  such  as  an  image  or  a 
Hadamard  transform  of  an  image. 

The  output  file  is  created  in  the  same  size  and  format  as  the  second 
input  file.  If  at  any  point  overflow  occurs,  the  output  takes  on  the 
largest  positive  or  negative  value  whichever  is  appropriate.  A count 
of  overflows  is  maintained  and  is  reported  to  the  user  at  the  end  of 
processing . 

Subroutines  Called: 


DI2DA , E .ERR,  F.CRE,  F.PTR,  F.RET,  F.SHUT,  GET" AM , FARCOF,  F.A02AS , 
RSTFPS , SAVFPS  and  TTYOUT 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 


FLTMUL 


o.  ru 


Program  Marne:  FPASC 


:r2cse : 


To  convert  from  binary  floating  point  to  an  ASCII  character  string. 

Cescriotion : 

■ ■ ■■  

Two  types  of  conversion  are  provided,  both  of  which  follow  FORTRAN 
conventions.  The  first  is  similar  to  the  FORTRAN  "F"  conversion.  That  is, 
the  binary  value  is  converted  to  its  equivalent  decimal  number  with  a decimal 
oint.  The  field  width  and  the  number  of  places  to  the  right  of  the  decimal 
oint  must  be  specified. 

The  second  type  provides  the  FORTRAN  "E"  type  conversion.  That  is,  the 
binary  value  is  converted  to  a decimal  number  multiplied  by  a power  of  ten. 
The  field  width  and  the  number  of  places  to  the  right  of  the  decimal  point 
must  be  specified  in  this  case  also. 

Subroutines  Called: 


SAVFPS , SAVREG,  RSTFPS  and  RSTREG 
illir.g  Sequence: 

Fixed  Format  Conversion: 


JSR 

BR 

.BYTE 

.BYTE 

.WORD 

.WORD 


R5  ,FPASCF 

.+8. 

Width  of  Field 

Number  of  Digits  to  the  Right  of  the  Decimal  Point 
The  Two  Word  Floating  Point  Number 
Address  of  the  Buffer  for  the  Converted  Number 
The  field  width  minus  the  number  of  decimal  digits  must  be  greater  than 
Exponential  Format  Conversion: 

JSR  R5 ,FPASCE 

3R  .+8. 

(The  parameter  list  is  identical  to  that  for  FFASCF> 

The  field  width  minus  the  number  of  decimal  diei‘r  ~ * • , 
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Program  Name : FPASC  (Continued) 

In  both  cases,  *'s  will  be  returned  in  the  buffer  if  a conversion  error 
occurred.  The  "C"  bit  is  set  if  this  occurs.  It  is  otherwise  clear. 

The  general  and  floating  point  register  contents  are  preserved. 


Program  Name : FPSQRT 


Purpose: 

To  compute  the  square  root  of  a floating  point  number. 

Description : 

The  square  root  of  a single  or  double  precision  floating  point  number  is 
computed.  The  precision  is  determined  from  the  status  register  within  the 
floating  point  processor.  An  initial  guess  at  the  final  value  is  made  based 
upon  the  half  of  the  exponent  value.  This  results  in  only  three  Newton 
iterations  required  for  single  precision  and  four  iterations  required  for 
double  precision. 

Subroutines  Called: 


None 

Calling  Sequence: 

JSR  R5, FPSQRT 

3R  .+4 

.WORD  Address  of  the  Single  or  Double  Precision  Floating 

Point  Argument 

The  result  is  returned  in  the  subroutine  argument  and  in  AC0.  The  general 
registers  are  not  affected.  Floating  point  registers  AC0,  AC1  and  AC2  are 
changed. 
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Program  Name : FPW 


Purpose : 

To  control  the  overall  process  of  creating  Fisher  pairwise  logic. 
Description : 

This  routine  monitors  the  processes  required  for  the  creation  of  Fisher 
logic.  It  performs  the  following  functions: 

1.  Allocate  buffer  space  for  the  various  operations. 

2.  Retrieve  the  mean  and  covariance  file. 

3.  Call  "FISHER"  to  compute  the  Fisher  vectors  for 
each  class  pair. 

4.  Insert  the  resulting  logic  into  the  current  logic 
file . 

Frior  to  execution,  this  routine  expects  that  a logic  tree  node  has  been 
selected  for  the  logic  and  that  the  appropriate  means  and  covariances  have 
been  computed  and  stored  in  the  file  "MCFILE.MC". 

Subroutines  Called: 

ADDNOD,  ADDSYM,  CLLOGF , E.ERR,  FISHER,  F.CLOS,  F.PTR,  F.P.ET,  GETMEA, 
GETNOD,  GETSYK,  GTLOGF,  LOADER,  OPENLF,  OPLOGF,  RSTREG , SAVREG , SETFIS, 

TTYIN,  and  TTYO 

Calling  Sequence: 

Entry  is  from  the  Executive  at : 

FPW 
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Program  Name:  FRAMES 


Purpose : 

To  create  the  option  frame  file. 

Description: 

This  routine  accepts  frame  building  input  from  a file  called  "FRAMES. SRC" 
Each  line  in  this  formatted  ASCII  file  is  expected  to  be  either  a comment, 
a blank  line,  a form  feed,  a total  frame  count,  a frame  header,  a frame  option 
entry  or  a frame  "end"  line.  The  lines  are  read  and  processed  according  to 
type  until  an  "end"  line  is  found.  At  that  time  the  frame  is  completed  and 
is  written  into  the  file  "FRAMES . IPS" . The  construction  of  the  next  frame 
is  then  begun.  This  process  continues  until  all  frames  are  complete. 

Subroutines  Called: 


None 

Calling  Sequence: 

This  routine  executes  as  a "stand-alone"  program  under  DOS.  The  entry 
point  is  "FRAMES". 
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Program  Name : GETBOL 


Purpose : 

To  create  Boolean  logic. 

Description : 

This  routine  directs  the  overall  creation  of  Boolean  logic.  The  logic 
is  entered  at  the  keyboard  as  a logical/arithmetic  expression.  It  is  accepted 
and  compiled  into  machine  code  by  the  routine  "CMPILB".  Following  its  entry 
the  user  is  given  the  option  to  reject  it  and  make  a new  entry. 

After  the  logic  has  been  accepted,  it  is  stored  in  the  logic  file  and 
two  subnodes  are  added  to  the  current  node.  The  class  assignments  for  each 
subnode  are  obtained  from  the  user. 

Subroutines  Called: 

ADDNOD,  ADDSYM,  CLLOGF,  CLOVEC,  CMPILB,  E.ERR,  GETNOD,  GETSYM,  GTLGGF, 
LOADER,  OPLOGF , OFNVEC,  OPTION,  RAD2AS , SI2DA , TTYIN  and  TTYOUT 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 

GETBOL 


: 


Program  Name;  GETCON 


To  plot  cross  sections  of  a filter  on  the  graphics  display. 

Description: 

This  routine  is  an  overlay  to  the  "CREFLT"  routine  which  creates  filter 
files.  The  function  is  passed  to  this  routine  as  machine  code.  If  any 
undefined  constants  exist  in  the  code,  this  routine  requests  them  from  the 
user.  The  user  is  also  queried  to  obtain  the  end  points  of  a line  in  the 
X-Y  filter  plane  through  which  a perpendicular  plane  is  inserted  to  obtain 
a cross  section  of  the  function.  This  cross  section  is  then  displayed  on 
the  graphics  display.  The  user  is  then  given  the  following  options: 

1.  Accept  the  filter  function; 

2.  Reject  the  function  and  go  back  to  "CREFLT" 
to  get  another; 

3.  Display  another  cross  section; 

4.  Exit  to  the  executive. 

Subroutines  Called: 

ALPHA,  CLEAR,  CREFLT,  DSABLR,  E.ERR,  FLTENT,  FPASCE,  GRMODE,  PLOT, 
RAD2AS,  RSTFPS , SAVFPS,  SNGDEC , TTYIN,  TTYO , TTYOUT  and  WHICH 

Calling  Sequence: 

JSR  R5, GETCON 


4-56 


Program  Name : GETIX 


Purpose : 

To  retrieve  a specified  element  of  a given  matrix. 

Description : 

This  routine  obtains  a matrix  element  specified  by  its  row  and  column 
position.  The  matrix  may  be  stored  in  either  single  or  double  precision 
floating  point  format.  As  a result,  one  of  two  initialization  routines  must 
be  called  prior  to  requesting  any  elements. 

Subroutines  Called: 


None 

Calling  Sequence: 

To  initialize  for  single  precision: 
JSR  R5 ,SETIXF 


To  initialize  for  double  precision: 
JSR  R5 ,SETIXD 

To  retrieve  a matrix  element: 


JSR 

R5, GETIX 

BR 

.+6 

.WORD 

Address  of  a 

location 

containing  the  row  number 

.WORD 

Address  of  a 

location 

containing  the  column  number 

Prior  to  calling  GETIX,  the  following  global  parameters  must  be  set: 

DIMEX  - Number  of  columns  in  the  matrix 

MATEX  - Core  address  of  the  matrix. 

The  core  address  of  the  element  is  returned  in  R3  and  the  element  itself 
is  returned  in  AC3.  All  other  registers  are  unaffected. 
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ov^-ram  Name;  GETMEA 

SEES*  mbers  from  the  user  for  Fisher  logic 

To  obtain  the  measurement  numbers 
creation • 


The 

“if-..-.  t^-stsktsw  ax  £;•= 

rs.HSss  “rir=='»  • - 

indicated  by  tne  * 

tTFIN  and  TTYO 

E.m.  ^KFG,  SAVHB.  H™ 

CallinS_Seauer^: 

JSR  R5 .GETMEA 

br  -+4 

WORD  ^DR 


where 


abr  . Address  of  a buffer £* 

ESETS*'  »umb« ;o< :--rintSi-reasins 

Measurement  numbers  ar 
order • 


AU  registers  are  preserved. 
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Program  Name : GTFILE 


Purpose : 

To  create  a checkerboard  test  image. 

Description : 

This  routine  creates  an  image  file  of  512  rows  and  512  columns.  The 
first  row  is  created  with  grey  value  0 in  the  first  32  columns,  1 in  the 
next  32  and  up  to  15  in  the  last  32.  This  row  is  then  copied  into  the 
image  file  32  times.  The  next  row  sequence  begins  with  value  16  in  the 
last  32  columns  and  increases  by  one  every  32  colums  until  reaching  the 
beginning  of  the  row.  This  row  is  then  copied  into  rows  33  thru  64  of 
the  file.  This  alternating  process  continues  until  all  rows  are  complete. 

Subroutines  Called: 


E.ERR,  F.CRE,  F.CLOS  and  F.PTR 


Calling  Sequence : 

Entry  is  from  the  Executive  at: 


GTFILE 


Program  Marne : HADMAR 


Purpose: 

To  perform  a scaled  Kadamard  transform  on  a one-dimensional  array  of 
double  precision  integers. 

Description : 

This  routine  computes  the  Hadamard  transform  in  the  classical  manner  of 
log  N steps  where  N is  the  number  of  elements.  The  sum  and  difference  opera- 
tions are  performed  between  two  buffers.  The  first  buffer  is  the  input  array 
and  the  second  is  a working  buffer.  If  N is  odd,  the  result  appears  in  the 
working  buffer.  In  this  case,  it  is  copied  back  into  the  array  buffer.  After 
the  Nth  step,  the  elements  are  rearranged  in  sequency  order.  If  during  any 
step  of  the  computation  overflow  occurs,  the  array  is  divided  by  two.  The 
number  of  divisions  is  returned  in  a scale  word. 

Subroutine  Calls: 

RSTREG  and  SAVREG 

Calling  Sequence: 


JSR  R5, HADMAR 

BR  .+10 

.WORD  Address  of  a working  buffer 

.WORD  Address  of  a location  containing  the  number  of  elements  in  the 
array 

.WORD  Address  of  array  to  be  transformed 

.WORD  Address  of  a scale  word 

The  result  is  returned  in  the  input  array.  The  scale  word  contains  the 
number  of  times  that  the  array  was  divided  by  two. 

All  registers  are  not  modified. 
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To  perform  a Hadamard  transform  on  a two-dimensional  array. 


Description: 

This  routine  applies  the  one-dimensional  Hadamard  transform  routine 
(HADMAR)  to  a two-dimensional  array.  This  is  accomplished  by  first  applying 
it  to  the  rows  and  then  applying  it  to  the  resulting  columns.  The  input  array 
can  either  be  an  image  or  a Hadamard  transformed  image.  The  output  is  then  a 
Hadamard  transformed  image  or  an  image,  respectively.  When  the  output  is  a 
Hadamard  transform,  the  option  is  provided  to  create  an  image  which  is  a 
scaled  version  of  the  transform.  A histogram  of  the  transform  is  displayed 
on  the  graphics  display  to  aid  in  selecting  boundaries  for  scaling. 

Subroutine  Calls: 


ALPHA,  BLDISP,  CHCUR,  CLEAR,  DSA3LR , ENAELR , E.ERR,  FPASCE,  F.CLOS, 
F.CRE,  F.CRES,  F.PTR,  F.RET,  F.SHUT,  GRMODE , HADMAR,  PLOT,  PAD2AS , 
RSTREG,  SAVREG,  SNGDEC  and  TTYOUT 


Program  Name:  HISPLT 


To  display  histograms  on  the  graphics  display. 

Description: 

This  routine  displays  a histogram  on  the  graphics  terminal  at  a specified 
location.  The  horizontal  and  vertical  limits  of  the  plot  must  be  provided 
along  with  the  number  of  bins  in  the  histogram.  Options  are  available  to  draw 
axes  and  to  draw  the  histogram  as  bars  or  lines  or  dotted  lines  connecting  the 
tops  of  what  would  normally  be  the  bars.  The  vertical  scaling  can  optionally 
be  controlled.  If  not  specified,  the  histogram  is  plotted  to  the  full  range 
of  the  space  provided. 

Subroutine  Calls: 

ALPHA,  DPSQP.T,  GRMODE,  PLOT,  RSTFPS,  RSTP.EG , SAVEPS  and  SAVREG 
Calling  Sequence: 

JSR  R5, HISPLT 

BR  .+6 

.WORD  Address  of  a parameter  list 

.WORD  Address  of  a buffer  containing  double  word  histogram  bin  counts 

(low  order  part  first  for  each  bin) 

Parameter  List 

.WORD  Upper  horizontal  limit  of  plot 

.WORD  Lower  horizontal  limit  of  plot 

.WORD  Upper  vertical  limit  of  plot 

.WORD  Lower  vertical  limit  of  plot 

.WORD  Number  of  bins  in  histogram 

.WORD  Spacing  between  bins  (return  parameter) 

.WORD  Axis  indicator 

0 = No  axis 

1 = Y axis  only 

2 = X axis  only 

3 = X and  Y axes 
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HISPLT  (Continued) 


.WORD  Type  of  histogram 

0 = Bars 

1 = Lines 

2 = Dashed  lines 

.WORD  Largest  double  word  (low  order  then  high  order)  value  to  be 

represented  as  full  scale.  If  the  first  word  is  -1,  then  HISPLT 
uses  the  largest  bin  count  in  the  histogram. 

.WORD  Double  word  minimum  count  in  histogram  (not  needed  if  previous 
parameter  is  -1). 

All  registers  are  preserved. 


r 


Program  Name:  INVMAT 

Purpose : 

To  invert  a matrix. 

Description: 

This  program  inverts  a square  matrix  of  four-word  floating  elements. 
The  result  is  returned  in  the  same  buffer. 

Subroutine  Calls: 

GETIX,  RSTREG  and  SAVREG 

Calling  Sequence: 

JSR  R5,  INVMAT 

3R  .+8. 

.WORD  Address  of  a location  containing  the  address  of  the  matrix 

.WORD  Address  of  a location  containing  the  address  of  a working 

buffer 

.WORD  Address  of  a location  containing  the  dimension  of  the  matrix 
General  registers  are  not  modified. 


Program  Name:  KEYARA 


Purpose : 


To  create  a region  file  based  on  keyboard  input. 
Description: 


This  routine  creates  a region  file  based  upon  user  keyboard  entries. 

The  entries  can  be  the  actual  coordinate  values  or  the  upper  left  coordinate 
value  of  a rectangular  region  and  its  dimensions.  A third  option  to  enter 
cursor  coordinates  from  an  image  display  has  been  included.  The  current 
effort,  however,  does  not  include  the  display  software. 


Subroutine  Calls: 


E.ERR,  F.CRE,  F.PTR,  F.RET,  F.RET$,  F.SHUT,  OPTION,  RSTREG,  SAVREG, 

SNGDEC,  TTYIN,  TTYO  and  TTYOUT 

Routines  that  are  not  included  in  the  current  effort  but  that  are  required 
for  cursor  coordinate  input  are  expected  to  have  the  following  calling 
sequences : 

Display  an  Image 

JSR  R5.DISP1 

BR  .+6 

.WORD  Address  of  image  file  request  block  (rile  must  not  be  open) 

.WORD  Blow  up  factor  (integer) 

Positive  values  blow  up  the  image  and  negative  values  shrink 
it . 

Values  of  -1,  0 and  1 cause  every  image  point  to  be  displayed. 
The  following  globals  must  be  set  prior  to  the  call: 


SROW 

First 

row  in  image  to  be  displayed 

SCOL 

= 

First 

column  in  image  to  be  displayed 

OL’TROW 

= 

First 

row  on  display  to  be  used 

OL’TCOL 

= 

First 

column  on  display  to  be  used 

Image  Display  Cursor 

Enable 

Cursor 

JSR 

R5 , 

ENABLC 
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KEYARA  (Continued) 


.WORD  Address  of  subroutine  to  call  when  coordinates  are  captured 
(when  cursor  interrupt  occurs) 

Disable  Cursor 


R5 ,DSABLC 


Clear  Image  Display  Graphics 


R5.CLRGRF 


Draw  Lines  on  Display 


R 5 , DRWLNE 


. WORD 


Address  of  a parameter  list 


Parameter  List: 


.'WORD 


Row  coordinate  of  point  1 


.WORD 


Column  coordinate  of  point  1 


.WORD 


Row  coordinate  of  point  2 


.WORD 


Column  coordinate  of  point  2 


Calling  Sequence: 


Entry  is  from  the  Executive  at: 


START 


The  image  display  cursor  routine  calls  the  following  subroutine  when  a 
coordinate  is  captured. 


R5,TAKCRD 


.WORD 


Row  coordinate  value 


.WORD 


Column  coordinate  value 


4-66 


KEYARA  (Continued) 


Both  row  and  column  display  values  begin  at  zero,  i.e.,  pixel  at  row 
column  1 is  displayed  at  display  point  0,0. 
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Program  Name : LINDEP 

Purpose : 


To  find  linear  dependent  rows  of  a matrix. 

Description: 

This  routine  generates  a list  of  dependent  rows  in  a specified  square 
matrix.  The  matrix  is  expected  to  be  in  four-word  floating  point  format. 

Subroutine  Calls: 

GETIX,  RSTREG  and  SAVREG 

Calling  Sequence: 

JSR  R5 , LINDEP 

BR  .+8 

.WORD  Address  of  a location  containing  the  address  of  the  matrix 

.WORD  Address  of  a location  containing  the  address  of  a buffer  in 

which  to  return  the  numbers  of  the  dependent  rows 

.WORD  Address  of  a location  containing  the  dimension  of  the  matrix 

The  return  buffer  consists  of  the  number  of  dependent  rows  in  the  first 
byte  and  the  numbers  of  the  dependent  rows  in  the  remaining  bytes. 

Registers  are  not  modified. 
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Program  Name: 
Pumose : 


LINES 


To  create  a binary  image  where  only  the  edges  of  objects  in  an  input 
grey  level  image  appear. 

Description: 

This  routine  finds  the  edge  points  of  objects  by  comparing  the  averages 
of  arrays  of  points  surrounding  each  pixel.  If  the  averages  exceed  a user 
specified  threshold  the  output  binary  point  is  set  at  255.  If  it  does  not 
exceed  the  threshold  the  output  value  is  zero.  The  array  averages  are  com- 
puted by  calling  the  "SMOOTH"  routine.  The  smoothed  image  is  stored  in  a 
temporary  file  for  processing. 

A second  option  called  "AREA  EDGE  DETECTION  MAX"  builds  upon  the  first 
option.  This  routine  considers  neighboring  row  and  column  positions  that 
have  also  exceeded  the  threshold.  The  position  that  exceeded  the  threshold 
by  the  greatest  amount  in  the  row  is  then  set  to  255.  The  same  action  is 
performed  on  the  column. 

Subroutines  Called: 


E . ERR,  F.CLOS,  F.CRE,  F.PTR,  F.RET,  RAD2AS , SI  2D  A , F.SH'JT,'  SMOOTH, 
SNGDEC,  TTYIN  and  TTYOUT 

Calling  Sequence: 


Entry  is  from  the  Executive  at: 

LINES  - Area  edge  detection 
LINES+2-  Area  edge  detection  max. 


4-69 


Program  Name : LNPRNT 


Purpose : 

To  print  specified  character  strings  on  the  line  printer. 

Description: 

This  routine  initializes  and  opens  the  line  printer  output  dataset. 
Character  strings  terminated  by  a null  are  then  accepted  and  listed  on  the 
line  printer.  A second  calling  point  is  available  to  close  and  release  the 
line  printer  dataset. 

Subroutines  Called: 

F.CLSE,  F.INIT,  F.OPEN,  F.RLSE,  RSTREG  and  SAVREG 
Calling  Sequence: 

To  print  one  or  more  ASCII  character  strings: 


JSR  R5, LNPRNT 

BR  Offset  to  end  of  parameter  list 

.WORD  Address  of  ASCII  character  string 

.WORD  Address  of  2nd  string  (optional) 


.WORD  Address  of  last  string  (optional) 

To  close  and  release  the  dataset: 

JSR  R5.LPCL0S 

Registers  are  not  modified. 


Program  Name:  LOG 


To  compute  the  natural  log  or  the  common  log  of  a number. 

Description : 

This  routine  computes  the  natural  log  of  a floating  point  number.  The 
method  used  is  described  by  Hart.Cl]  The  common  log  (base  10)  is  computed 
from  the  natural  log  by  multiplying  by  the  constant  Log^Ce). 

Subroutines  Called: 

(See  calling  description) 

Calling  Sequence: 

To  compute  the  common  log: 

•JSR  R5,L0G 

To  compute  the  natural  log: 

JSR  R5,LN 

In  both  of  the  above  cases  the  calling  and  return  arguments  are  in 
floating  point  processor  register  0. 

If  any  error  occurs  in  the  computation  (log  of  0,  etc.)  this  routine 
will  call  a programmer  supplied  routine  that  must  be  given  the  name  "LOGERR". 
The  call  format  is : 

JSR  PC,  LOGERR 

If  the  error  routine  returns  via  an  "RTS  PC",  the  original  value  in  AC0  is 
returned  unmodified. 

General  and  floating  point  registers  are  modified. 
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Program  Name : LOGGER 


Purpose : 

To  provide  a high  level  access  to  the  logic  file. 

Description: 

This  routine  contains  subroutines  to  open,  close  and  access  the  logic 
file.  Included  are  routines  to  add,  delete  and  retrieve  logic  tree  nodes 
and  class  symbols. 

Subroutines  Called: 

E.ERR,  F.CLOS,  F.EXT,  F.PTR  and  F.RET 

Calling  Sequence: 

Open  the  logic  file  for  multiple  page  read  access: 

JSR  R5.0PLF 

BR  .+8 

.WORD  Address  containing  the  address  of  the  I/O  buffer 

.WORD  Address  containing  the  length  of  the  I/O  buffer 
.WORD  Address  of  the  logic  file  name 

Upon  return  MAXCON  contains  the  maximum  number  of  pages  that  may  be  accessed 
at  one  time. 

Open  the  logic  file  for  single  page  read  access: 


JSR  R5 ,OPENLF 

BR  .+8 

.WORD  Address  containing  the  address  of  the  I/O  buffer 

.WORD  Address  containing  the  length  of  the  I/O  buffer 

.WORD  Address  of  the  logic  file  name 

Open  the  logic  file  for  single  page  modify  access: 


JSR  F 

BR 

.WORD  t 

.WORD  f 

.WORD  f 

Close  the  logic  file 


R5.0PL0GF 

.+8 

Address  containing  the  address  of  the  I/O  buffer 
Address  containing  the  length  of  the  I/O  buffer 
Address  of  the  logic  file  name 


R5.CLL0GF 


Close  the  logic  file 


R5.CLLF 
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LOGGER  (Continued) 


Set  a pointer  to  one  page  of  the  opened  logic  file. 

JSR  R5 ,GTLOGF 

BR  .+6 

.WORD  Address  containing  the  append  count 

.WORD  Address  containing  the  page  number  to  retrieve 

The  logic  file  may  be  opened  by  using  any  of  the  previously  defined 
open  subroutines.  The  append  count  is  the  number  of  pages  to  add  to  the 
file  if  the  requested  page  does  not  physically  exist. 

Upon  Return: 

R3  contains  the  address  of  the  logic  page 

FLOGP  contains  the  first  page  number  resident 

LLOGP  contains  the  last  page  number  resident  plus  one 

Set  a pointer  to  the  requested  logic  pages  located  in  the  opened  logic  file. 
(The  logic  file  must  be  opened  previously  via  a call  to  OPLF.): 


JSR 

R5 ,GTLF 

3R 

.+6 

j 

.WORD 

Address 

containing 

the  number  of  pages  to  read  1 

.WORD 

Address 

containing 

the  starting  page  number 

Upon  return: 

R3  contains  the  address  of  the  first  logic  page 
FLOGP  contains  the  first  page  number  resident 
LLOGP  contains  the  last  page  number  resident  plus  one 

Add  one  level  of  nodes  to  a lowest  node  in  the  logic  tree  block  of  the  opened 
logic  file.  (The  logic  file  must  be  opened  via  a call  to  the  subroutine 
OPLOGF. ) : 


JSR 

R5  ,ADDN0D 

BR 

.+10 

.WORD 

Address  containing  node  number  where  nodes  are  to 
be  added 

.WORD 

Address  containing  the  number  of 
level  Uf  of  branches) 

nodes  on  -che  new 

.WORD 

Address  to  transfer  control  upon 

error 

The  error  return  is  executed  if: 

1.  The  specified  node  does  not  exist 

2.  The  specified  node  is  not  a lowest  node 


LOGGER  (Continued) 


Delete  one  level  of  logic  nodes  associated  with  a superior  node  from  the 
logic  tree  block  of  the  opened  logic  file.  (The  logic  file  must  be  opened 
via  a call  to  OPLOGF.): 

JSR  R5 , DELNOD 

BR  .+6 

.WORD  Address  containing  the  superior  node  number 
.WORD  Address  to  transfer  control  upon  error 

The  error  return  is  executed  if: 

1.  There  is  more  than  one  level  of  nodes  below  the  superior  node 

2.  The  specified  superior  node  is  a lowest  node  or 

3.  The  specified  superior  node  does  not  exist. 

Retrieve  a node  from  the  logic  tree  block  of  the  opened  logic  file.  (The 
logic  file  may  be  opened  via  any  of  the  previously  defined  open  subroutines, 
but  if  the  node  information  is  to  be  modified,  the  subroutine  OPLOGF  must 
be  used  to  open  the  file.): 

JSR  R5,GETN0D 

BR  .+6 

.WORD  Address  containing  the  node  number  to  retrieve 

.WORD  Address  to  transfer  control  if  the  node  is  inactive. 

(Error  Return) 


Upon  Return; 


R1  contains  the  address  of  the  logic  node 
Upon  Error  Return: 

If  R1=0  the  logic  page  is  not  defined  for  the  node,  otherwise 
the  node  is  inactive. 

Retrieve  a class  symbol  entry  from  the  class  symbol  block  of  the  opened 
logic  file.  (The  logic  file  may  be  opened  via  any  of  the  previously  defined 
open  subroutines,  but  if  the  information  is  to  be  modified,  the  subroutine 
OPLOGF  must  be  used  to  open  the  logic  file.): 

JSR  R5.GETSYM 

BR  .+6 

.WORD  Address  containing  the  node  number  entry 

.WORD  Address  to  transfer  control  upon  error 

Upon  Return: 

R2  contains  the  address  of  the  second  byte  in  the  entry,  i.e. 
the  number  of  symbols.  The  class  symbols  follow  in  successive 
bytes. 
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LOGGER  (Continued) 


Upon  Error  Return: 


An  entry  associated  with  the  requested  node  does  not  exist  in 
the  class  symbol  block. 

Delete  a class  symbol  entry  from,  the  class  symbol  blocl  of  the  opened  logic 
file.  (The  logic  file  must  be  opened  via  a call  to  OPLOGF.): 

R5  .DELSYM 

.+6 

Address  containing  the  node  number  of  the  entry 
Address  to  transfer  control  upon  error 

An  error  occurs  if  the  subroutine  fails  to  find  an  entry  associated  with  the 
node  number  located  in  the  parameter  list. 

Add  a symbol  entry  to  the  class  symbol  block  of  the  opened  logic  file.  (The 
logic  file  must  be  opened  via  a call  to  OPLOGF.): 

R5  ADDSYM 

.+5 

Address  containing  the  address  of  the  class  symbol 
entry 

Address  to  transfer  control  upon  error 
The  class  symbol  entry  is  described  as  follows : 

Byte  Description 

£ Node  number 

1 Number  of  symbols 

2 First  symbol  (ASCII) 

Last  Symbol 

An  error  occurs  if  there  already  exists  an  entry  in  the  class  symbol  logic 
block  for  the  node. 


JSR 

BR 

. WO  RB 
. WORD 
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To  start,  stop  or  dump  the  log. 


description : 

This  routine  controls  the  operation  of  the  automatic  log  routine  found 
in  EXEC.  To  start  the  log  the  log  file  LOGFIL.IPS  is  created  as  a linked 
file.  If  the  file  exists  the  user  is  asked  if  it  should  be  listed.  It  is 
then  deleted  and  recreated.  The  log  routine  is  then  enabled  by  setting  bit 
2 of  the  parameter  "LOGFLG". 

The  log  is  stopped  by  clearing  bit  0 of  the  parameter  "LOGFLG".  The 
file  is  not  deleted. 

The  log  file  can  be  dumped  at  any  time  regardless  of  whether  the  log 
is  active  or  not. 

Subroutines  Called: 

E.ERR,  F. DEL,  SNGDEC , TTYIX , TTYIO  and  TTYOUT 
Calling  Sequence: 

Entry  is  from  the  Executive  at: 

LOGOVR 


Program  Name : LPHDCP 


Purpose : 

To  list  grey  value  or  binary  images  on  the  line  printer. 

Description : 

This  routine  lists  grey  value  or  binary  images  on  the  line  printer.  A 
three  digit  number  is  printed  for  each  pixel  value  within  the  user  selected 
portion  of  the  image.  For  binary  images  binary  1 is  printed  as  an  asterisk 
and  a binary  0 as  a blank.  If  the  number  of  columns  is  greater  than  the 
width  of  the  line  printer,  the  output  is  generated  in  several  sections. 

Subroutines  Called: 


E . ERR,  F.CLOS,  F.PTR,  F.RET, 
SUGDEC,  TTYO  and  TTYOUT 


LPCLOS , RAD2AS , SI2DA,  SI2 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 


EDGPRN  - List  binary  image 

GRYDMP  - List  grey  value  image 


Proeram  Name : MDOTV 


Purpose : 


To  compute  the  dot  product  between  a matrix  and  a vector. 


Description : 


This  routine  forms  the  dot  product  between  a matrix  and  a vector.  The 
elements  of  each  must  be  in  floating  point.  Single  or  double  precision 
values  are  accepted.  The  processor  must  be  set  to  the  desired  precision 
prior  to  entry.  The  column  dimension  of  the  matrix  must  equal  the  dimension 
of  the  vector. 

Subroutines  Called: 


GETIX , RSTREG  and  SAVREG 
Calling  Sequence: 

JSR  R5, MDOTV 

BR  .+12 

.WORD  Address  of  the  address  of  the  matrix 

.WORD  Address  of  the  address  of  the  vector 

.WORD  Address  of  the  address  for  the  result 

.WORD  Address  of  the  number  of  columns  in  the  matrix 

.WORD  Address  of  the  number  of  rows  in  the  matrix 

Registers  A C0 , AC1  and  AC3  are  modified. 
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Program  Name : MENCOV 


r 


Purpose : 

To  compute  the  mean  vector  and  covariance  matrix. 

Description: 

The  mean  vector  and  covariance  matrix  is  computed  for  each  class  in  the 
current  data  set.  Only  those  vectors  which  are  located  at  the  current  logic 
tree  node  will  be  used  for  the  caluclations . The  output  is  stored  in  the 
file  "MCFILE.MC".  If  the  file  exists,  it  is  deleted  and  recreated. 

Subroutines  Called: 

CLLOGF , CLOVEC,  E.ERR,  F.CLOS,  F.CP.E,  F.DEL,  F.PTR,  GETSYM,  GETVEC, 
LOADER,  OPE'.'LF , OPNVEC,  RSTREG,  SAVREG  and  SI.’GDEC. 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 

MEMCOV 


Purpose : 

To  generate  the  file  ERRORS. IPS. 
Description: 


This  routine  converts  the  error  message  format  of  file  ERROPS  SPr 

aco„erable  f°™at  °f  two 

input  file.  One  pass  counts  the  error  types  and  the  messages  within  each 

Soon  deteJI™  the  =1“  =f  the  output  file  which  is  coSiJuoJs  The 
second  pass  then  accomplishes  the  reformatting. 

Subroutines  Called : 


None 

Calling  Sequence: 

This  routine  is  executed  via  the  DOS  RUN  command.  Entry  is  at 
MESAGE 


Program  Name:  MODREP 


Purpose: 


To  remove  image  noise  points. 


Description : 

This  routine  determines  the  modal  value  of  the  pixels  within  a 3 by  3 
neighborhood  of  each  image  point.  If  the  center  point  differs  in  value  by 
more  than  a specified  amount,  it  is  replaced  with  the  modal  value. 

Subroutines  Called: 


E . ERR,  F.CRE, 


F.PTR,  E.RET,  F.SHUT, 


RAD2AS , RSTRE3  and  SAVREG 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 
MCDREP 
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Program  Name: 


NORMLZ 


To  normalize  an  image. 

Description: 

The  normalization  process  is  performed  in  one  of  two  ways.  Either  the 
image  grey  values  are  expanded  to  the  full  0 to  255  range  or  the  values  are 
normalized  over  a user  specified  range.  The  function  performed  is  dependent 
upon  the  entry  point. 

Subroutines  Called: 

E.ERR,  F.CRE,  F.PTR,  F.RET,  F.SHUT,  RAD2AS,  RSTREG,  SAVREG,  SI2DA  and 
SNGDEC 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 

NORMLZ  - Normalize  over  0-255  range 

NORMLZ+2  - Normalize  over  the  user  specified  range. 
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Program  Name:  OPTION 


Purpose : 

To  display  option  lists  and  accept  selections. 

Description : 

This  routine  simply  lists  a specified  option  list  (not  frame  option 
lists)  on  the  graphics  display  and  accepts  the  user's  input.  The  return 
address  is  then  selected  on  the  basis  of  this  input.  The  number  of  options 
is  determined  by  the  length  of  the  parameter  list. 

Subroutines  Called: 

E.ERR  and  SNGDEC 

Calling  Sequence: 

JSR  R5, OPTION 

BR  Offset  to  end  of  parameter  list 

.WORD  Address  of  output  option  list 

.WORD  Address  of  option  1 return 

.WORD  Address  of  option  2 return 


Registers  are  not  modified 


Program  Name : PARCOR 

Purpose : 

To  partition  the  free  core  buffer. 

Description : 

This  routine  divides  the  buffer  "FRECOR"  into  a number  of  fractional 
parts.  The  addresses  and  sizes  of  these  parts  are  then  placed  directly  into 
request  blocks. 

Subroutines  Called: 

SAVREG  and  RSTREG 

Calling  Sequence : 

JSR 
BR 

.WORD 
. WORD 
.WORD 


Registers  are  not  modified. 


R5,  PARCOR 

Offset  to  end  of  parameter  list 
Denominator  of  fraction 
Numerator  of  1st  fractional  part 
Address  of  buffer  address  parameter  in  file 
request  block 

(any  number  of  additional  2 word  entries). 
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Program  Name : PLOT 


Purpose : 

To  provide  routines  for  generating  graphic  plots  on  the  Tektronix 
display. 

Description : 

Several  subroutines  are  contained  within  this  program  which  together 
allow  graphic  plots  to  be  easily  generated.  A special  character  string 
output  routine  is  also  provided  because  the  DOS  driver  does  not  allow  control 
characters  to  be  transferred  to  the  terminal. 


Subroutines  Called: 

E.ERR,  RSTREG  and  SAVREG 
Calling  Sequence: 

To  select  alpha  mode: 


JSR  R5, ALPHA 


To  select  graphics  mode: 


JSR  R5.GRM0DE 

To  clear  screen: 

JSR  R5, CLEAR 


The  display  is  left  in  alpha  mode  with  the  cursor  at  the  upper  left  margin. 
To  position  the  cursor  at  the  "home"  position: 


JSR 

R5.H0ME 

The  display  is 

left  in 

graphics  mode. 

To  plot  a 

vector: 

JSR 

R5.PL0T 

BR 

.+6 

.WORD 

Address  of  X 

coordinate 

.WORD 

Address  of  Y 

coordinate 

This  routine  draws  a dark  vector  if  the  call  is  immediately  preceeded  by  a 
call  to  GRMODE.  Successive  calls  to  PLOT  draw  light  vectors. 


PLOT  (Continued) 


To  output  a single  character: 

JSR  R5 ,OUTCAR 

The  ASCII  character  must  appear  in  R4, 

To  output  a graphics  character  string: 

JSR  R5 ,TTYGRF 

BR  .+4 

.WORD  Address  of  a character  string  which  is  terminated 

by  a null. 

After  this  call  the  global  "TTYADR"  is  set  to  the  next  byte  address  follow 
the  terminating  null  character. 

Registers  are  not  modified. 


4-87 


Program  Name:  PTEDGE 


Purpose : 

To  find  object  edges  in  grey  value  images. 

Description: 

This  routine  is  designed  to  find  points  which  are  the  edges  of  objects, 
i his  is  accomplished  by  comparing  each  point  to  user  specified  neighbor 
points.  If  the  difference  exceeds  a user  specified  threshold,  the  output 
point  is  set  to  255.  Otherwise  the  output  value  is  0. 

Subroutines  Called: 

E .ERR,  F.CRE,  F.PTR,  F .RET , F.SHUT,  RAD2AS , SI2DA  and  SNGDEC 
Calling  Sequence: 

Entry  is  from  the  Executive  at: 

PTEDGE 


4-88 


E 


Program  Name : PWLINR 


Purpose : 

To  accept  and  apply  user-specified  piecewise-linear  transfer  functions. 
Description : 

This  routine  allows  the  user  to  specify  the  transfer  function  by  entering 
coordinates  at  the  keyboard.  These  coordinates  describe  the  end  points  of 
the  linear  sections.  The  transfer  function  can  be  saved  in  a file  for  future 
use . 


The  newly  specified  transfer  function  or  a previously  existing  one  can  be 
applied  to  an  image  via  this  routine. 

Subroutines  Called: 


ALPHA,  3LDISP,  CLEAR,  DSA3LR , ENABLR,  E.ERR,  F.CRE,  F.RET,  F.PTR,  F . SHUT , 
GRMODE,  OPTION,  OUTCAR,  PARCOR,  PLOT,  RAD2AS , SNGDEC , TRNFTN , TTY IN,  TTYO 
and  TTY OUT 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 
PWLINR 
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Program  Name : 


RAD2AS 


Purpose : 

To  convert  RAD50  characters  to  ASCII 
Description : 

This  routine  converts  a string  of  RAD50  packed  characters  to  an  ASC 
string.  The  DOS  programmed  request  ".RADUP"  is  used. 

Subroutines  Called: 


RSTREG  and 

SAVREG 

Calling  Sequence 

JSR 

RS,  RAD2AS 

BR 

.+8 

.WORD 

Address  of  RAD50  string 

.WORD 

Address  for  ASCII  output 

.WORD 

Number  of  words  in  RAD50  string 
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Program  Name : 


RENAME 


Purpose : 

To  rename  a file 


Description : 

This  routine  allows  a file  to  be  renamed.  The  old  file  name  and 
new  name  are  obtained  from  the  user.  No  change  in  the  extension  is  allowed. 

Subroutines  Called: 

E.ERR,  F.RNM  and  GETNAM 


Calling  Seauer.ce: 


Entry  is  from  the  Executive  at: 


Program  Name : RGSTAT 


Purpose : 

To  compute  and  list  region  statistics. 

Description : 

This  routine  computes  and  lists  on  the  graphics  display  or  line  printer 
the  mean,  standard  deviation,  mode,  and  population  of  a selected  region  of 
an  image  file  or  sets  of  regions  and  images  as  described  by  a spectral  set 
file . 


Subroutines  Called: 


BEGFND,  BLDISP,  CFREQ,  CSDEV,  CLEAR,  DSABLR , ENABLR,  E.ERR,  F.CLOS, 

F.PTR,  F.RET,  F.SHUT,  FINDPT,  GMEAN , GSDEV , GMEDN , GMODE , LNPRNT,  RAD2AS , 
RSTREG,  SAVREG,  SI2DA,  SMINIT,  SNGDEC , TTYIN,  and  TTYO. 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 


RGSTAT 


Operate  on  spectral  set 


RGSTAT+2 


Operate  on  single  region/image  pair 
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Program  Name : 


RTIOMG 


Purpose : 

To  compute  the  ratios  of  two  images  on  a point  by  point  basis. 

Description : 

This  routine  makes  two  passes  through  the  file.  On  the  first  pass,  the 
range  of  values  is  obtained  by  multiplying  each  image  point  to  be  normalized  by 
256  and  dividing  the  result  by  the  reference  image  point.  On  the  second 
pass,  these  values  are  then  normalized  between  0 and  255. 

Subroutines  Called: 


E.ERR,  F.CRE,  F.PTR,  F . RET , F.SHUT,  PARCOR,  RAD2AS , and  TTYOUT 
Calling  Sequence: 


Entry  is  from  the  Executive  at: 
RTIOMG 
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Program  Name : SARFPS 


Purpose : 

To  save  and  restore  the  status  of  the  floating  point  processor. 
Description: 

The  FPP's  registers,  status  register,  and  error  trap  vector  are  saved 
on  and  restored  from  the  stack : 

Subroutines  Called: 

None 

Calling  Sequence: 

To  save  the  FPP  status: 

JSR  R5 , SAVFPS 
To  restore  the  FPP  status: 

JSR  R5 , RSTFPS 


i- 


Program  Name : SAVER 


Purpose : 

To  save  and  restore  the  general  registers  RO  - R5. 

Description : 

The  general  registers  RO  - R5  are  saved  on  and  restored  from  the  stack. 
Subroutines  Called: 

None 

Calling  Sequence: 

To  save  registers: 

JSR  R5 , SAVREG 
To  restore  registers: 

JSR  R5 , RSTREG 
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Program  Name : SELNOD 


Purpose: 

To  obtain  the  node  number  from  the  user  and  to  call  the  appropriate 
logic  routine. 

Description : 

This  routine  requests  the  desired  node  number  from  the  user  and  stores 
it  in  the  global  location  "LOGNOD".  Control  is  then  passed  to  the  logic 
creation  overlay  associated  with  the  entry  point  chosen. 

Subroutines  Called: 

E. ERR,  LOADER,  and  SNGDEC 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 

SELNOD  - Fisher  logic 

SELNOD  + 2 - Boolean  logic 
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Program  Name : SELOGF 


Purpose : 

To  retrieve  or  create  a logic  file. 

Description: 

The  existence  of  the  current  vector  set  is  checked  as  described  by  global 
"VECTNM. " A fatal  error  is  reported  if  none  exists.  The  logic  file  name  is 
requested  next.  If  the  file  exists,  the  class  symbols  in  the  vector  file 
set  and  the  logic  file  are  compared  to  insure  compatibility.  Tfie  vectors  are 
all  reset  to  node  1 in  the  logic  tree.  The  logic  evaluation  overlay  is  then 
called  to  apply  any  existing  logic  to  the  vectors. 

If  the  file  does  not  exist,  a new  one  is  created.  The  class  symbols  are 
extracted  from  the  vector  file  and  placed  in  the  logic  file. 

Subroutines  Called: 


ADDSYK,  CL10GF,  CLOVEC, 
GTLOGF , LOADER,  OPENLF , 


CRLOG , E.ERR,  F.CHK,  GETNAM 
OPNVEC , RSTREG,  SAVREG,  and 


, GETSYM, 
TTY  OUT . 


GETVEC, 


Calling  Sequence: 


Entry  is  from  the  Executive  at: 


START 


Program  Name : SELVEC 


To  obtain  the  vector  set  file  name  for  future  logic  operations . 
Description: 

This  routine  requests  the  vector  set  file  name  from  the  user  and  stores 
it  in  the  global  variable  "VECTNM" . The  vector  set  is  opened  to  obtain 
the  vector  dimension,  the  vector  measurement  format  indicator  and  the  vector 
header  format  indicator.  These  are  stored  in  global  locations  VECDIK  , 
"VECMFI"  and  "VECHFI"  respectively. 

Subroutines  Called: 

GETNAM,  OPNVEC  and  CLOVEC 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 


SELVEC 


r 

Program  Name : SHIFTI 

Purpose : 

To  shift  an  image  vertically  and  horizontally. 

, Description : 

This  routine  shifts  an  image  by  a user  specified  row  and  column  amount. 
The  shift  is  accomplished  by  a circular  rotation  of  the  rows  and  columns  in 
the  image. 

Subroutines  Called: 

E.ERR,  F.CRE,  F.PTR,  F . RET , F.SHUT,  RAD2AS , SI 2D A and  SNGDEC 
Calling  Sequence: 

Entry  is  from  the  Executive  at: 

SHIFTI 
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SIMSMO  - M by  N smoothing  array 
BOXSMO  - Square  smoothing  array 


Program  Name:  SPAMEZ 


Purpose : 

To  compute  the  mean,  variance,  standard  deviation,  median,  mode,  high, 
low  and  range  of  a set  of  numbers. 

Description : 

The  statistics  are  computed  on  a frequency  table  that  is  constructed 
by  this  routine.  The  frequency  table  is  the  number  of  times  that  each 
grey  value  occurred  in  the  data  passed  to  "CFREQ". 

Subroutines  Called: 

RSTFPS , RSTREG , SAVREG,  SAVFPS  and  SQRT 
Calling  Sequence: 

To  initialize  the  frequency  buffer,  the  sum  and  the  sum  of  squares 
prior  to  calling  CFREQ,  CMEAN  and  CVARIi 

JSR  R5 ,SMINIT 

BR  .+8. 

.WORD  Address  of  data  value  (byte  value  at  an  even  location) 

to  be  supplied  by  CFREQ,  C MEAN  or  CVARI.  Also  this 
is  the  address  where  the  computed  values  are  returned 
from  GMEAN,  GVARI,  GSDEV,  GMEDN , GMODE,  GHIGH,  GLOW 
and  GRANGE 

.WORD  Address  of  a 256  word  buffer  for  the  frequency  table. 

•WORD  Address  of  the  number  of  data  values. 

.WORD  Address  of  mode  flag.  This  is  an  optional  parameter. 

It  must  be  supplied  if  GMODE  is  used. 

The  mode  flag  is  set  by  GMODE  to  the  number  of  modes 
minus  one. 

To  tally  a byte  of  data  into  the  frequency  table : 

JSR  R5, CFREQ 

To  add  data  to  the  current  sum: 

JSR  R 5, CMEAN 
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To  add  data  to  the  sum  and  the  square  of  data  to  the  sum  of  squares: 


JSR  R5.CVAP.I  (or  CSDEV) 

To  calculate  the  mean  of  the  data : 

JSR  R5.GMEAN 

CMEAN  must  be  called  first 
To  calculate  the  variance  of  the  data: 

JSR  R5.GVARI 

CVARI  must  be  called  first. 

To  calculate  the  standard  deviation  of  the  data: 
JSR  R5.GSDEV 

CVARI  must  be  called  first. 

To  calculate  the  median  of  the  data: 

JSR  R5  ,GMEDII 

CFREQ  must  be  called  first. 

To  calculate  the  mode  of  the  data: 

JSR  R5.GM0DE 

CFREQ  must  be  called  first. 

To  calculate  the  high  data  value: 

JSR  R5 ,HIGH 

CFREQ  must  be  called  first. 

To  calculate  the  low  data  value: 

JSR  R5 , LOW 

CFREQ  must  be  called  first. 

To  calculate  the  range  of  values: 

JSR  R 5, RANGE 

CFREQ  must  be  called  first. 
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Program  Name : SPBIAS 


Purpose : 


To  add  a constant  to  an  image . 


Description: 

This  routine  simply  adds  a user  specified  constant  to  each  point  in  an 
image . 

Subrout ine  Calls: 


DI2DAR,  F.CRE,  F.PTR,  F.RET, 


F . SHUT , RAD2AS,  SI2DA,  SNGDEC  and  TTYOUT 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 
SPBIAS 
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Program  Name:  SQRT 


Purpose : 

To  compute  the  square  root  of  a number. 

Description: 

This  routine  computes  the  square  root  of  a double  or  single  precision 
integer.  The  value  is  computed  using  Newton's  method  with  an  initial  guess  of 
(2**15 )-l. 

Subroutine  Calls: 

RSTREG  and  SAVREG 

Calling  Sequence: 

Double  precision  argument: 

JSR  R5.DPSQRT 

BR  .+4 

.WORD  Address  of  the  double  precision  integer  (lov;  order  part  first) 

The  square  root  is  returned  in  the  low  order  word  of  the  argument. 

Single  precision  argument: 

JSR  R 5, SQRT 

3R  .+4 

,V?CRD  Address  of  single  word  integer 

The  square  root  is  returned  in  place  of  the  argument. 

Registers  are  not  modified. 


4-105 


Program  Name : TAPE 

Purpose : 

To  perform  various  tape  operations. 

Description: 

This  routine  reads  and  writes  image  files  from  and  to  magnetic  tape. 
The  images  are  stored  on  tape  as  one  row  per  record.  The  last  record  is 
followed  by  an  end-of-file  mark. 

A skip  file  option  and  a rewind  option  are  also  available. 

Subroutine  Calls: 

E.ERR,  F.CLOS,  F.CRE,  F.INIT,  F.PTR,  F.RET,  F.RLSE,  SNGDEC  and  TTYOUT 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 


ENTRY 

ENTRY+2 

ENTRY+4 

ENTRY+6 


Read  tape  file 
Write  tape  file 
Skip  tape  file 
Rewind  tape 
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Program  Name:  TEKDSP 


Purpose : 

To  display  a binary  image  on  the  Tektronix  display. 


Description : 


This  routine  displays  a binary  image  on  the  Tektronix  where  binary  "one" 
points  are  displayed  as  a dot  (period)  and  binary  "zero"  points  are  displayed 
as  a blank  position.  The  user  can  specify  that  an  array  of  dots  be  used  for 
a point  and  he  can  also  specify  the  spacing  between  dots.  Both  have  a "blow 
up"  effect. 

Subroutine  Calls : 

ALPHA,  BLDISP,  CLEAR,  E.ERR,  F.PTR,  F.RET,  F . SHUT , GF.MODE , HOME , PLOT, 
RAD2AS , SI2DA , SNGDEC,  TTYIN,  TTYO  and  TTYOUT 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 


TEKDSP 
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Program  Name:  TELEIO 


Purpose : 


To  provide  graphics  display  I/O. 

Description: 

This  routine  allows  character  strings  to  be  printed  on  the  graphics 
display  and  to  be  accepted  from  the  keyboard.  Two  output  routines  are  inclu- 
ded. One  appends  a carriage  return  and  line  feed  to  the  string,  and  the  other 
does  not. 

The  rebuilding  of  the  option  frames  is  also  controlled  by  this  routine . 
Two  calling  sequences  are  provided  to  enable  and  disable  this  function. 

Subroutine  Calls: 

E.ERR,  LOGGER,  RSTREG  and  SAVREG 

Calling  Sequence: 

To  output  a character  string  with  appended  carriage  return  and  line  feed: 
JSR  R5 ,TTY0UT 


.WORD 


Address  of  output  string  (terminated  with  a null) 


To  output  a character  string  without  appending  characters: 
JSR  R5.TTY0 


.WORD 


Address  of  output  string  (terminated  with  a null) 


Following  calls  to  either  TTYOUT  or  TTYO,  the  global  parameter  "TTYADR"  is 
set  to  the  address  of  the  first  byte  after  the  null. 

To  input  a character  string 

JSR  R5 ,TTYIN 


.WORD  Input  buffer  address 

The  word  immediately  preceeding  the  buffer  must  contain  the  size  of  the  buffer 
in  bytes.  The  input  string  is  terminated  with  a null  in  place  of  the  final 


4-108 


TELEIO  (Continued) 


carriage  return  and  line  feed. 

To  enable  frame  rebuild: 

JSR  R5.ENABLR 

The  line  counter  is  reset  to  the  maximum  (LIHMAX). 
To  disable  frame  rebuild: 

JSR  R5 , DSAELR 


I 

* 

* 
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Program  Name:  TMPARA 


Purpose : 


To  report  that  the  image  display  options  are  not  implemented. 
Description: 

This  routine  simply  prints  "OPTION  INOPERATIVE!!!"  when  called, 
is  then  returned  to  the  executive. 


Subroutine  Calls: 


TTYOUT 


Calling  Sequence: 

JSR  R5,DISPl'(ENABLC,  DSABLC , CLRGRF  or  DRWLNE ) 


Control 
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Program  Name:  TRNFTN 

Purpose : 

To  apply  an  image  transfer  function. 

Description: 

This  routine  applies  a specified  transfer  function  to  an  image.  This 
function  is  in  the  form  of  a 256  byte  look-up  table.  The  input  image  grey 
value  is  used  as  an  index  into  this  table  to  determine  the  output  value. 

Subroutine  Calls: 

F.PTR,  P.STP.EG  and  SAVREG 

Calling  Sequence: 

JSR  R5.TRNFTN 

BR  .+8. 

.WORD  Address  of  input  file  request  block 

.WORD  Address  of  output  file  request  block 

•WORD  Address  of  transfer  function  in  memory. 

Registers  are  not  modified. 


i 


Program  Name:  TTYIO 

Purpose : 


To  provide  high  level  terminal  I/O. 

Description : 

This  routine  provides  terminal  I/O  functions  that  request  parameters  from 
the  user  and  accept  his  response.  These  parameters  include  file  specifications 
and  numerical  input  (octal  and  decimal).  Floating  point  numerical  input  is 
accepted.  Routines  also  are  provided  to  convert  ASCII  character  strings  to 
binary. 

Subroutine  Calls : 

E.ERR,  RSTFPS , RSTREG,  SAVFPS,  SAVREG,  TTYIN  and  TTYO 
Calling  Sequence: 

Output  a message  and  input  a file  specification  (the  file  name  is  checked 
for  legality) 

JSR  R5 ,GETNAM 

BR  .+6 

•WORD  Address  of  message 

.WORD  Address  of  a 12  word  return  buffer 

This  buffer  will  contain  a link  block  in  the  1st  5 words  and  a file  block 
in  the  last  7 words  upon  return.  Link  and  file  blocks  are  as  described  in 
the  DOS  monitor  programmer's  handbook.  If  the  device  or  unit  number  is  not 
given,  zero  is  returned.  The  "wild  card"  specification  is  not  altered  by 
this  routine  (52  octal  is  passed  to  the  calling  routine  as  explained  in  the 
DOS  programmer's  handbook). 

Output  a message  and  input  a file  specification  (the  file  name  is  not 
checked  for  legality.  Only  the  device  is  of  interest). 


JSR 

R5.GETDEV 

BR 

.+6 

(The  parameter  list  is  identical  to  that  for  GETNAM.) 

Output  a message  and  input  a string  of  signed  double  word  integer  decimal 
numbers . 

JSR  R5 ,DBLDEC 


4-112 


TTYIO  (Continued) 


Offset  to  end  of  parameter  list 
Address  of  message 

Address  of  location  containing  the  maximum  count  of  numbers  to 
input.  This  count  must  be  satisfied  exactly  or  an  error  message 
is  printed  and  a request  is  made  to  retype  the  line. 

Address  of  array  for  numbers 

This  array  must  contain  sufficient  space  to  store  all  the  numbers 
indicated  by  the  second  parameter.  The  numbers  are  entered 
on  the  keyboard  separated  by  commas  and  preceeded  by  a minus 
or  plus  sign.  The  absence  of  a sign  is  interpreted  as  a plus 
sign.  Zero  is  returned  for  a given  number  if  its  corresponding 
field  is  empty  (comma  only). 

Address  of  location  containing  CTRL-Z  indicator  (optional 
argument ) 

When  specified  this  argument  indicates  that  the  first  character 
entered  is  to  be  compared  to  a CTRL-Z.  If  the  character  is  net 
a CTRL-Z,  a zero  will  be  returned  in  the  indicator.  If  it  is  a 
CTRL-Z,  then  a -1  is  returned. 

Output  a message  and  input  a string  of  signed  single  word  integer  decimal 
numbers . 

JSR  R5.SNGDEC 

BR  Offset  to  end  of  parameter  list 

(The  parameter  list  and  description  is  indetical  to  DBLDEC 
except  that  single  word  values  are  returned.) 

Output  a message  and  input  a string  of  signed  single  byte  integer  decimal 
numbers . 

JSR  R5 ,BYTDEC 

BR  Offset  to  end  of  parameter  list 

(The  parameter  list  and  description  is  identical  to  DBLDEC 
except  that  single  byte  values  are  returned.) 

Output  a message  and  input  a string  of  signed  double  word  integer  octal 
numbers 

JSR  P.5  ,DBLOCT 

BR  Offset  to  end  of  parameter  list 

(The  parameter  list  and  description  is  identical  to  DBLDEC.) 


BR 

.WORD 

.WORD 

.WORD 


.WORD 


* 

H 
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TTY 10  (Continued) 


Output  a message  and  input  a string  of  signed  single  word  integer  octal 


numbers . 

JSR 

R5 ,SNG0CT 

BR 

Offset  to  end  of  parameter  list 

(The  parameter  list  and  description  is  identical  to 
except  that  single  word  values  are  returned.) 

DBLDEC 

Output 
numbers . 

a message  and  input  a string  of  signed  single  byte  integer  octal 

JSR 

R5.BYT0CT 

BR 

Offset  to  end  of  parameter  list 

(The  parameter  list  and  description  is  identical  to 
except  that  single  byte  values  are  returned.) 

DBLDEC 

Output 
numbers  can 

a message  and  input  a floating  point  string  of  numbers, 
be  in  "F"  or  "E"  format. 

These 

JSR 

BR 

R5.FLTENT 

Offset  to  end  of  parameter  list 

(The  parameter  list  and  description  is  identical  to  DBLDEC 
except  single  precision  floating  point  values  are  returned.) 

Convert 

a signed  decimal  ASCII  character  string  to  binary. 

JSR 

R5, CONVIO 

Prior  to  entry,  R2  should  be  loaded  with  the  address 
character  string.  The  binary  value  will  be  returned 
null  or  a comma  terminates  the  string. 

of  the 
in  R1 . 1 

Convert 

a signed  octal  ASCII  character  string  to  binary. 

JSR 

R5.CONV8 

(Parameters  are  passes  as  for  CONVIO.) 
General  and  FPP  registers  are  not  modified. 
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Program  Name:  UTILTY 

Purpose : 

To  provide  an  exit  to  DOS . 

Description : 

This  routine  exits  to  DOS  via  an  "EMT  60". 

Subroutine  Calls:  None 

Calling  Sequence: 

Entry  is  from  the  Executive  at: 

DOS 


Program  Name:  VECFNS 


Purpose : 

To  provide  sequential  access  to  vectors  in  a vector  set. 

Description : 

This  routine  provides  services  to  open  a set  of  vector  files  listed  in  a 
vector  set  file,  to  access  the  files  and  to  close  the  files.  The  access  is  on 
a vector  by  vector  basis.  The  vectors  are  returned  sequentially.  Only  one 
vector  file  is  open  at  a time. 

Subroutine  Calls: 

E.ERR,  F.CLOS,  F.PTR,  F.RET,  F.RET$,  RSTREG  and  SAVREG 
Calling  Sequence: 

Open  vector  set: 

JSR  R5,0PNVEC 

BR  .+12. 

.WORD  Address  of  the  address  of  an  I/O  buffer 

.WORD  Address  of  the  length  of  the  buffer 

.WORD  Address  of  a four  word  vector  set  file  specification  (device, 
unit,  and  filename) 

.WORD  Address  of  location  containing  open  access  (0  = read,  1 = 
read/write) 

.WORD  Address  of  a three  word  buffer  for  return  parameters. 

Word  0 = Vector  dimensionality 

Word  1 = Measurement  format  indicator  (from  file  header) 

Word  2 = Vector  header  format  indicator  (from  file  header) 
Retrieve  next  sequential  vector: 

JSR  R5 ,GETVEC 

BR  .+4 

.WORD  Return  address  when  no  further  vectors  remain 
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VECFNS  (Continued) 


The  memory  address  of  the  vector  is  returned  in  RO. 
Close  vector  set: 

JSR  R5 ,CLOVEC 


Program  Name: 


WTDSMO 


Puroose : 


To  perform  a weighted  smooth. 


Description : 

This  routine  performs  the  smooth  by  operating  on  a user  specified  neigh- 
borhood  of  each  point.  Each  neighbor  is  multiplied  by  a weight  which  is  store 
in  a weight  array.  This  array  is  equal  in  dimension  to  that  of  the^neighbo 
hood.  The  sum  of  the  products  is  then  divided  by  the  sum  of  the  weights,  the 
sum  of  the  weight  absolute  values  or  a user-entered  number.  The  form  of  this 
divisor  is  specified  by  the  user. 

Subroutine  Calls: 

BYTDEC,  E .EF.R,  F.CRE,  F .PTR,  F.P.ET,  F.SKUT,  OPTION,  RAD2AS , SI2DAR , 
SNGDEC . TTYIN,  TTYO  and  TTYOUT 


Calling  Sequence: 

Entry  is  from  the  Executive  at: 

WTSMO  - Weighted.  smooth 

A3SWS  - Absolute  value  weighted  smooth 
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APPENDIX  A 


MEMORY  MAP 


The  fo1 lowing  diagram  is  a map  of  memory  when  the  image  processing  system 
is  loaded  and  executing.  Specific  addresses  are  not  provided  since  they  may 
vary  depending  upon  the  parameters  used  when  building  the  system. 


160000 


ENDCOR 
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APPENDIX  B 


SYSTEM  TABLES 


A number  of  system  tables  exist  which  are  used  to  store  the  current 
operating  state  of  the  system.  With  one  exception,  they  deal  with  the  opening 
and  closing  of  data  files  and  DOS  data  sets.  The  exception  is  concerned  with 
the  option  entries  associated  with  the  frame  being  displayed.  Due  to  the 
specialized  nature  of  this  table,  it  is  described  in  Appendix  C along  with 
the  frames  and  the  frame  file . 

The  first  table  deals  with  the  files  that  have  been  opened  by  file  calls 
F.CRE  and  F.RET.  As  a file  is  opened,  its  associated  request  block  address 
is  stored  in  the  first  non-used  slot.  The  table  is  located  in  program  EXEC 
at  label  "FSLOTS".  Its  format  is  as  follows: 

Word  Description 

0 Number  of  slots  in  table  (currently  1C). 

1 Request  block  address  of  an  open  file  (0  if  slot  is  empty). 

2 Same  as  word  1 


As  the  files  are  closed,  their  associated  entries  are  removed  from  the  table. 

Another  table  is  used  to  store  the  list  of  data  sets  that  have  been 
".INIT'ed"  by  DOS  as  requested  via  the  F.INIT  file  call.  This  table  is  also 
found  in  program  EXEC,  but  under  the  label  "ISLOTS".  This  table  has  the  same 
format  as  FSLOTS  except  that  the  link  block  addresses  are  stored  and  the 
number  of  slots  in  the  table  is  set  at  five.  The  entries  are  removed  when 
their  associated  data  sets  are  released  via  the  file  call  F.FLSE. 

The  last  table  is  used  to  store  the  list  of  files  that  have  been 
"OPENed"  by  DOS.  Again,  this  table  is  found  in  EXEC  under  the  label  "OSLOTS". 
The  format  of  this  table  is  also  the  same  as  FSLOTS  except  that  the  associated 
link  block  addresses  are  stored  and  the  number  of  slots  in  the  table  is  set 
at  five.  The  entries  are  removed  when  their  associated  files  are  closed  via 
the  file  call  F.CLSE. 

If  it  becomes  necessary  to  expand  any  of  the  above  tables,  program.  EXEC 
must  be  modified.  This  is  accomplished  by  changing  the  first  word  of  the 
affected  table  to  reflect  the  number  of  required  slots  and  then  expanding  the 
buffer  space  assigned  to  the  table.  After  EXEC  has  been  re-assembled,  the 
entire  system  must  be  rebuilt. 


APPENDIX  C 


SYSTEM  FRAMES 


The  frames  actually  form  a system  table  where  each  frame  is  one  page 
of  the  table.  The  frames  reside  on  disk  in  a contiguous  file  and  are 
paged  into  memory  (buffer  FRMTBL  in  program  EXEC)  as  required  by  the  system. 
Each  page  consists  of  a maximum  of  256  words  and  appears  in  the  file  in  the 
following  format: 


Word 


Description 


0 

1 


2 

3 


First  Option  Entry 


4 


Second  Option 
Entry 


Frame  number  in  binary 

Frame  0:  The  total  number  of  frames 

All  other  frames:  Not  used 

Reserved  for  future  use 

If  the  related  option  references 

another  frame  this  contains  the 

characters  "FRM"  packed  into  RAD 5 0 

format.  If  the  option  references  an 

overlay,  this  contains  the  last  three 

characters  of  the  overlay  name. 

The  lower  byte  contains,  the  frame 
number  if  the  option  references  a 
frame,  or  the  overlay  entry  point 
number  if  the  option  references  an 
overlay.  The  first  entry  point  is  0. 
The  upper  byte  is  reserved  for  future 
system  use. 

Reserved  for  future  system  use. 

Same  as  word  3 
Same  as  word  4 
Same  as  word  5 


Last  Option  Entry  (Max.  of  20) 

64  - 255  Beginning  of  frame  text.  One  character  string  appears 

here  for  each  option  entry  above.  The  first  character 
string  is  the  frame  header.  Each  string  is  terminated 
by  a "$"  except  the  last  string  which  is  terminated  by 
"$$".  All  text  is  packed  into  RAD50  format. 

The  frames  are  stored  in  consecutive  order  in  the  contiguous  file 
"FRAMES . IPS" . If  the  logical  block  size  of  the  device  is  less  than  256  words, 
then  several  blocks  are  used  to  store  each  frame.  If  the  logical  block  size 
is  greater  than  256  words,  then  only  one  frame  is  stored  per  block.  In  this 
case  the  remaining  words  in  each  block  are  not  used. 


C-l 


1 


The  frames  are  not  specified  by  the  user  in  the  format  discussed 
above.  Instead,  a more  easily  managed  file  called  FRAMES. SRC  is  created. 
This  file  is  in  formatted  ASCII  form  and  its  current  contents  are  listed 
on  the  following  pages.  Consult  Section  3 for  frame  changes. 
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|v,  io03  STATISTICS 

lUH'OOTj  0 IMAGE  HI. SIOGRAMS 

i " i ;•  o o ' .•■  i r e g i i ) n i i i s t o g r a m s 

;iUR047  0 REGION  STATISTICS 
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KNFkM  12  DISPLAY  OPTIONS 

KNTRM  0 MASTER  FRAME 

i ID 

* * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * Y 
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00R022  0 WEIGH TED  SMOOTH 
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(pul  KM  12  DISPLAY  OPTIONS 

IPMI'EM  0 MASTER  FRAME 

END 
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RATIO  IMAGES 
DISPLAY  OP  I IONS 
MASTER  FRAME 
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FRMO09  l;  I A I I I RE  EXTRACTION 

i 'OR 0 49  0 SPECIFY  SPECTRAL  FILE  SET 

OUR 049  I SPECIFY  VECTOR  FILE  SET 

0 0 R 0 <}  8 I C R E A T E 8 P E C . D E S 1 0 N 0 E C . I I L E 

OUR  0-4  8 0 CREATE  SPEC.  TEST  UEC.  FILE 

CRN FRO  12  DISPLAY  OPTIONS 

I RNFIXM  O MASTER  FRAME 
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FRM01.0 
1 1 0 R 0 4 5 
001X040 
OUIX044 
OUR 0 4 4 
i.i  UR  04  3 
OUR 050 
I RNFRM 
I PNI  IV  ri 
END 


LOGIC  DESIGN 
SELECT  U EC TOR  SET 
SELECT  LOGIC  TREE 
CREATE  FISHER  LOGIC 
C R E A T E B 0 0 1...  F A N I...  0 G I C 
EVALUATE  LOGIC 
CREATE  THEMATIC  MAP 
DISPLAY  OPTIONS 
MASTER  FRAME 


t * *. * Y Y * * Y Y Y Y * * * * * Y Y Y Y * Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y Y * Y Y Y Y Y Y Y Y Y Y Y Y Y - 


F Rjj  0 I 1.  E 1 1...  E M A N I PUL  A I I OMS 

OUI  '0 1 6 0 DEL  ETE  FILES 

OUR 0:1. 7 0 RENAME  FILES 

OUR 028  I SHORT  DIRECTORY 

0 U R 0 2 8 0 I...  0 N G D I IX  E C T 0 IX  Y 

0VR03 5 0 TAPE  INPUT 

O0E035  I TAPE  OUTPUT 

001X035  2 SKIP  TAPE  FILES 

001X035  3 REWIND  TAPE 

I R N I-'  IX  M 1 2 D I S P I...  A Y 0 P T 1 0 N S 

(RNFRM  0 MASTER  FRAME 

END 
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APPENDIX  D 


ERROR  MESSAGES 

The  system  error  file  ERRORS. IPS  contains  the  error  messages  for  all 
error  conditions  that  might  occur  during  normal  system  execution.  This  file 
is  contiguous  with  a header  that  has  the  following  format: 

Word  Description 

0 Offset  in  32  word  blocks  to  error  type  0 

1 Offset  in  32  word  blocks  to  error  type  1 

NOTE:  Currently,  only  two  error  types  are  defined. 

The  remainder  of  the  file  consists  of  the  error  messages,  each  stored  in 
a 32  word  block.  The  message  begins  in  the  first  byte  of  the  block.  The 
37th  and  38th  characters  are  filled  with  a carriage  return  and  line  feed 
respectively.  The  64th  character  contains  a null  to  signal  the  end  of 
the  message. 

If  the  device  logical  block  size  is  greater  than  256  words , then  the 
additional  words  are  not  used.  This  is  due  to  the  fact  that  the  memory 
error  buffer  is  256  words  in  length. 

The  errors  are  not  entered  by  the  user  in  the  above  format.  Instead 
the  file  ERRORS. SRC  is  edited  either  via  the  editor  or  modification  cf  the 
card  deck.  In  this  file  the  error  entry  consists  of  one  line.  The  messs 
must  be  limited  to  64  characters.  The  37th,  38th,  and  64th  characters  mu 
be  blank.  The  file  is  in  formatted  ASCII  form  and  is  listed  below : 


<n  on 


I m 


EO.O,  SPECIFIED  FILE-  IS  NONEXISTENT 
I O.l.  FILE  HAS  INCUR  El:  C T DATA  TYPE 
I < ) , 2 . I N C 0 R R E C T F 1 1...  E S P E C I F . F 0 R M A T 
E 0,3*  INPUT  STRING  SYNTAX  ERROR 
I 0 . 4 - I LI.  EGAL  FRAME  NUMBER 
I 0.5.  IT.  LEGAL  OPTION  NUMBER 
I:  0 . 6 . INPUT  STRING  TOO  LONG 
L 0,7,  PREVIOUS  PREMATURE  FILE  CLOSE 
I-  < > , 8 , P F F E R F N 0 E 1 1 P I C T U R E E L E M E N I 
l 0 . ‘r  ' D U P I...  I C A T E F 'l  l...  E N A M E 
F 0 , 1 0 , I N C 0 R R E C T P A R A M E I E R V A I...  U E 
E0,1:I,  A NONEXISTENT  PICTURE  ELEMENT 
10, 12,  INCORRECT  NUMBER  OF  ENTRIES 
EO , 1 3 , INCORRECT  F I LE  F ORMAT 
EO . :l  4 , ILLEGAL.  FILE  NAME 
LA,  i , S PF  C J.  F I E I.i  I- 1 1 ...  E I S N 0 N E X I.  S T E N I" 
10, 16,  IT  LEGAL  DEO  ITT-' 


- RETYPE 

- RETYPE 

- RETYPE 
-■  RETYPE 

- INPUT  IGNORED 


INPUT"  IGNORED 
RETYPE 

TYPE  CO  TO  CONTINUE 


RFT'Y'F 

RET'YF 

RETYP 

INPUT 

RETYF 


R'ETYPE 


"NCED 


IGNORED 


EO,  1.7,  INCORRECT 


RET YPE 


F:  0 , 1 Of 

* 

IT. 10  MANY  PARENTHESES 

••••  RETYPE 

EO,  1.9 

♦ 

II  LEGAL.  CHAR 
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APPENDIX  E 


DATA  FILE  DESCRIPTIONS 


Several  different  file  formats  are  used  within  the  system  to  store 
- various  data  types.  Each  type  is  identified  by  a different  filename  exten- 

sion. The  descriptions  of  each  type  are  found  on  the  following  pages. 

Certain  items  in  the  file  headers  are  common  to  all  types.  These  items 
are  found  in  the  first  and  last  64  words  of  the  header.  The  first  64  words 
are  as  follows: 

Word  Description 

0 

i 
3 
4 


5-63 

The  last  64  words  of  the  header  are  used  to  store  the  descriptive  text.  This 
text  can  contain  embedded  carriage  returns  ar.d  line  feeds  ar.d  is  terminated 
with  a null. 


Reserved  for  future  use 
Filename  extension  (RAD5C) 

Total  number  of  records  in  file 
Record  length  in  bytes 
File  close  indicator 

0 = File  was  normally  closed 

1 = File  was  prematurely  closed 
Peserved  for  future  use 


File  Type:  Function  File 

Extension • .FCT 

Special  Header  Parameters: 


Word  Description 

64  Set  to  negative  one  to  show  non-array  file 

65  Function  indicator:  set  to  1 for  one- 
dimensional function.  Set  to  2 for  two- 
dimensional  function. 


Data  Format: 

This  file  type  is  used  to  store  the  compiled  code  associated  with  a 
filter  function.  The  entire  buffer  returned  by  the  compiler  routine  "COMPIL" 
is  stored  as  one  record  in  this  file.  Consult  "COMPIL"  documentation  for 
detailed  information.  The  file  format  follows  (only  one  record  in  file): 

Word  Description 

0 Number  of  words  in  this  record 

1 Offset  to  compiled  code  relative  to  word  0 

2 Offset  to  symbol  table  relative  to  word  0 

3 Offset  to  symbol  values  relative  to  word  0 

4 Filter  function  in  the  original 

ASCII  string  format 


Symbol  table 
Compiled  code 


Symbol  values 
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Word  DescriDtior. 


64 • Array  format  indicator.  Set  to  3 to  show 

two-word  floating  point. 

Data  Format: 

This  file  type  is  used  to  store  filter  arrays.  The  elements  of  the  array 
are  in  two-word  floating  point  format.  One  row  of  elements  is  stored  in  one 
record.  The  number  of  records  is  equal  to  the  number  of  rows  in  the  filter 
array. 


File  Type : 
Extension: 


Hadamard  Transform  File 


Special  Header  Parameters: 


Description 

Array  Element  Format  Indicator 

1 = Word  elements 

2 = Double  word  elements 


Data  Format : 


This  file  type  is  used  to  store  Hadamard  transform  arrays.  The  elements 
of  the  array  are  as  indicated  above.  One  row  of  elements  is  stored  in  one 
record.  The  number  of  records  is  equal  to  the  number  of  rows  in  the  Hadamard 
array . 


4- 


File  Type:  Image  File 

Extension : . IMG 

Special  Header  Parame-1  rs : 
Word 
64. 

lata  Format: 


Description 

Set  to  zero  to  indicate  integer  byte  array 
elements . 


This  file  type  is  used  to  store  images.  One  row  of 
stored  in  one  record.  The  number  of  records  is  equal  to 
in  the  image . 


picture  elements  is 
the  number  of  rows 


File  Tvre : 


Logic  Tree 


Extension:  .LOG 

Special  Header  Parameters:  None 

Lata  Format: 


ibis  file  type  is  used  to  store  logic  trees  and  their 
Each  record  in  the  file  is  called  a page  where  record  1 is 
are  always  512  bytes  in  length.  The  formats  of  the  various 
retailed  on  the  following  pages. 


associated  logic, 
page  0.  The  records 
page  types  are 


Directory  Page  - Page  0 (F.ec.  1) 


Word 


Description 


0 

1 


f2 


Entry 

± 


; 3 

4 


Number  of  active  entries  in  directory 
Number  of  currently  active  pages  in  file 
Low  byte:  Logic  tree  node  number  if  entry 

is  associated  with  logic.  This 
is  set  to  zero  for  non-logic 
entries 

High  byte:  Entry  identifier: 

1 = One-Space  Logic  (to  be 

added) 

2 = Two-Space  Logic  (to  be 

added) 

3 = Fisher  Pairwise  Logic 

4 = Boolean  Logic 

5 = Reserved  for  future 

logic  tyre. 

6 = Logic  Tree 

7 “ Class  symbols 

Fage  number  of  block  described  by  this 
entry 

Number  of  pages  in  this  block 


Entries  continue  in  the  same  format  as 
entry  1. 


Page  1 (R ec.  2)  Reserved  for  Future  Use 


Logic  Tree  Block  - Page  2 (Rec.  3) 
(Additional  Logic  Tree  Pages  are  created  as  required.) 


Byte 

0 

1 

2-9 

10-509 

510-511 


Description 

Current  page  number 
Number  of  active  entries 
Reserved  for  future  use 
Fifty,  ten  byte  node  entries  * 
Not  used 


Node  Entry  Format 


Note : 


Byte 


Description 


0 

1 

2-5 

6 

7 


8 

9 


Node  number.  Zero  if  entry  is  inactive 

Node  level  in  tree 

Reserved  for  future  use 

Node  number  of  immediate  senior  node 

Number  of  nodes  on  next  level  below  this 

node.  Zero  indicates  that  the  current  node 

is  a terminal  node. 

Node  number  of  first  node  below 
Node  number  of  the  next  node  on  the  current 
level  which  has  the  same  immediate  senior 
node.  Zero  indicates  that  the  current 
node  is  the  last  node  on  this  level. 


Node  numbers  begin  at  1 and  are  assigned  consecutively  as 
requested  by  the  logic  creation  routines. 

Node  levels  also  begin  at  1 with  the  senior  node  and  increase 
consecutively  at  each  lower  level. 
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(Additional 

Class  Symbol  pages  are  created  as  required) 

Byte 

Description 

0 

Number  of  entries  on  this  page 

1-511 

Class  Symbol  Entries.*  Each  entry 
variable  length.  There  is  no  space 

entries . 

Class  Symbol  Entry  Format 


Byte 


Description 

Node  number  in  logic  tree  with  which  the 
symbols  are  associated. 

Number  of  symbols  in  this  entry 
1st  class  symbol 
2nd  class  symbol 


Last  class  symbol 


Fisher  Pairwise  Logic 


A set  of  Fisher  logic  corresponding  to  one  node  in  the  logic  tree  may 
occupy  several  consecutive  logic  file  pages.  The  logic  consists  of  a header 
block  which  is  stored  in  one  or  more  pages  and  the  logic  components  which 
are  also  stored  in  one  or  more  pages.  In  both  cases  when  extending  beyond  a 
page,  continuation  takes  place  at  the  beginning  of  the  next  page.  The  logic 
components  begin  at  the  top  of  the  first  page  after  the  header. 


Header  Format 


Word 


Description 


0,1 

2 

3 

4 

5 

6 

7 

8 


9,10 

11 

12 


General 

Information 

Region 


Class 

Symbol 

Region 


Reserved  for  future  use 

Number  of  bytes  in  this  header  (always 

even) 

Offset  from  top  of  header  to  the  general 
information  region 

Offset  from  top  of  header  to  the  class 
symbol  region 

Offset  from  top  of  header  to  the  criterion 
description  region 

Offset  from  top  of  header  to  the  measure- 
ment description  region 
'Minimum  vote  count 

Number  of  the  highest  dimension  with 
< which  the  logic  was  created  (not  necessarily 
the  dimensionality  of  the  vectors) 

^Reserved  for  future  use 
(Number  of  classes 

Low  Byte:  Node  number  to  which  the  class  is 
associated 

High  Byte: Class  symbol 


'A  one  word  entry  appears  for  each  class 
plus  one  extra  entry  for  the  reject 
^category) 
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.’.'umber  of  measurements  used. 
Measurement  numbers  used 
(or.e  byte  per  entry) 


Fisher  Criterion  Format 


Word 


Description 


Fisher  vector  in  two-word  floating 
point  format . NDIM  is  the  largest 
dimension  with  which  the  logic  was 
created.  This  is  not  necessarily  the 
dimensionality  of  the  vectors. 

This  is  the  discriminant  vector  for 
the  above  Fisher  vector.  This  is  not 
currently  used,  but  is  stored  for 
future  use. 


Two-word  floating  point  threshold 
values .* 


(The  above  is  repeated  for  each  class 
pair.  ) 


" Five  thresholds  are  computed  and  stored  for  each  class  pair.  Only 

threshold  three  is  currently  used  by  logic  evaluation.  The  other  thresh- 
olds are  stored  for  possible  future  software  additions.  The  thresholds 
are  computed  as  follows : 

Let  U.  be  the  estimated  mean  of  class  i projected  onto  the  Fisher 
direction  d,  i ,e . , 

M.  = dTX.  i = 1,2 
1 ~ -l 

where  X.  is  the  mean  of  class  i. 

~i 

Then  the  thresholds  are: 


y2  - A/2 

U2  + A/3 


#GMK 


Boolean  Logic  Format 


Description 

Reserved  for  future  use 
Number  of  bytes  in  logic 
Low  Byte:  Node  number  of  false  node 
High  Byte:  Node  number  of  true  node 
Address  of  compiled  code  relative  to  word 
0 

Address  of  symbol  table  relative  to  word  0 
Address  of  symbol  values  relative  to  word  0 
Input  ASCII  character  string  terminated 
with  a null 


Symbol  Table 


Compiled  Code 


Symbol  Values 


Symbol  Table  Format 


Definition 

Number  of  symbols 
Status  word  for  symbol  1 
RAD50  pack  of  symbol  1 
Status  word  for  symbol  2 
RAD50  pack  of  symbol  2 


Status  word  for  last  symbol 
RAD50  pack  of  last  symbol 


Status  Word  Format 


Low  Byte : 


High  Byte: 


This  is  always  set  to  1.  Other 
values  returned  by  the  compiler 
are  net  accepted  by  the  logic 
creation  routine.  (See  COMPIL 
for  other  values.) 

Set  to  the  measurement  number 
(binary)  which  the  symbol  repre- 
sents . 


Calling  the  Compiled  Code 


The  compiled  code  is  called  as  follows: 

JSR  PC,(adr.  of  code) 

Prior  to  this  call,  the  values  of  all  measurements  for  the  current  vector 
must  be  provided.  These  values  are  placed  in  the  buffer  area  identified  by 
word  6 of  the  Boolean  logic.  The  first  four  words  of  this  area  are  reserved 
for  special  subroutine  addresses.  The  first  three  should  be  filled  with  the 
entry  point  addresses  of  the  EXF,  LH  and  LOG  routines  respectively.  The  fourt 
is  a special  routine  for  image  neighborhood  operations.  This  feature  of  the 
compiler  will  not  occur  in  the  logic.  Therefore,  this  word  is  not  used. 

Following  the  four  special  addresses  appear  the  measurement  values  in 
the  order  of  appearance  within  the  symbol  table.  All  values  are  in  two-word 
floating  point.  The  logical  result  is  returned  in  PI  as  1 for  true  or  a C 
for  false. 
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Mean-Covariance  File 


File  Type: 

Extension : .MC 

Special  Header  Parameters:  None 

Data  Format: 


This  file  type  is  used  to  store  the  mean  vectors  and  covariance  matrices 
from  which  Fisher  logic  is  created.  One  record  exists  in  the  file  for  each 
class.  The  record  format  follows: 


Word 


Description 


0 

1,2 

3 


Class  symbol  in  lower  byte . Upper  byte 
unused . 

Two-word  floating  point  count  of  the  number 
of  vectors  used  in  computing  the  mean  ar.d 
covariance 
MV  ^ 

MV]T  Two-word  floating  point  mean 

. vector.  NDIM  is  the  number  of 

. r dimensions  in  the  vector  set. 

MV 

NDIM 

Upper  Triangle  of  covariance  matrix 
This  is  stored  by  row  beginning  with  the 
diagonal  element. 
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This  file  type  is  used  to  store  region  boundary  description.  The  coor- 
dinate pairs  of  the  vertices  are  stored  one  each  in  a four  byte  record.  Each 

record  contains  the  row  coordinate  value  in  the  first  two  bytes  and  the 

column  coordinate  value  in  the  last  two  bytes.  The  last  record  contains  the 

same  coordinate  pair  as  the  first  record.  This  forces  a closed  boundary. 


File  Type: 


Spectral  Set  File 


Extension : .SPC 

Special  Header  Parameters: 

Word  Description 

64  Always  0 

65  Number  of  image  file  names 

66  Number  of  region  file  names 

Tata  Format: 

This  file  type  is  used  to  store  the  description  of  a set  of  spectral 
images.  Also  included  are  names  of  region  files  from  which  vectors  can  be 
created.  The  record  length  is  14  bytes  where  each  record  contains  an  image 
file  specification  or  one  region  file  specification.  Image  file  specifica- 
tions appear  first,  followed  by  the  region  file  specifications.  The  formats 
are  as  follows: 


Spectral  Set  File  Pecord  Format 


Image  File  Names: 

Word 

0 

1 

2-3 

4 

5 

6 
7 


Description 

Device  name  (RAD50) 
Unit  No. 

File  Name  (RAD50) 
Extension  (RAD50) 
User  ID 
Not  Used 
Not  Used 


Region  File  Names: 

Word 

0 

1 

2-3 

4 

5 

6 
7 


Description 

Device  Name  (RAD50) 
Unit  No. 

File  Name  (RAD50) 
Extension  (RAD50) 

User  ID 

Class  Symbol 

Data  Reduction  Factor 
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Vector  File 


Extension: 


Special  Header  Parameters: 


Description 


66 

67 

68-69 

70 

71 

72 

73 


Meas.  Format  Ind. 

0 = Integer  Byte 

1 = Integer  Word 

2 = (Not  used) 

3 = Fit.  Pt.  (Single  precision) 

4 = (Not  used) 

Vector  Header  Format  Indicator 

Bit  0:  0 = Perm,  and  Temp.  Sym. 

Space  not  Allocated 
1 = Perm  and  Temp.  Sym. 
Space  Allocated 

Bit  1:  0 = Row  and  Column  not  pre- 

sent 

1 = Row  and  Column  present 
Total  number  of  meas.  per  vector 
Number  of  vectors  per  record 
Total  number  of  vectors 
Row  dimension  of  original  image 
Column  dimension  of  original  image 
Vector  length  in  bytes  (always  even) 
Number  of  spectral  measurements 


Data  Format: 

This  file  type  is  used  to  store  measurement  vectors . Each  vector  file 
corresponds  to  one  image  file  from  which  the  vectors  were  extracted.  Depend- 
ing upon  the  total  number  of  vectors,  one  or  more  vectors  may  be  stored  in 
a record.  This  is  done  to  keep  the  record  count  to  single  precision.  When 
more  than. one  vector  is  stored  per  record,  the  records  are  packed  with  no 
intervening  space.  The  format  of  the  vector  is  as  follows: 

Word  Description 


Measurements  (see  header  word  64 
for  format) 


Low  Byte:  Node  number 
High  Byte:  Not  used 
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Low  Byte : Temporary  class  symbol 
High  Byte:  Permanent  class  symbol 
Row  number  in  image  at  which  vector  was 
found 

Column  number  in  image  at  which  vector  was 
found 


1 

i 


.? 


I 

* 

!* 


i 


] 
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APPENDIX  F 


SUBROUTINE  LIBRA.RY 


The  following  is  a listing  of  the  subroutine  library  which  is  stored 
in  file  "LIBR.OBJ": 


LI HR  VOS A 


1...  IBR 

♦ LS 

03 -DEI 

BEG. 

Nome 

VERSION 

OOOO 1 

H ADM OR 

0001 

00002 

SMOOTH 

0001 

00003 

1 RNFTN 

000.1 

00004 

HI  BELT 

0001 

00005 

COMP  II... 

0001 

00006 

EOAL.FP 

0001 

0000  / 

E UAL  BE 

0001 

00008 

SPAMEZ 

0001 

000O9 

PARC  OR 

0001 

000:10 

r i m i ip  t 

000 1 

0001. 1. 

LUGGER 

0001 

000.12 

0 EOF MB 

0001 

000.1 3 

OR  LOG 

0001 

00014 

SORT 

0001 

000 1 5 

OPT  ION 

0001 

0001 A 

CB2I5A 

0001 

00<)  1 7 

RAD 2 AS 

0001 

00018 

AB2RAD 

0001 

00019 

LNPRNT 

0001 

00020 

LOG 

0001 

00021 

EXE 

' 0001 

00022 

E P A SC 

oooi 

00023 

01  TOUR 

000.1. 

00024 

TMPARA 

0001 

00025 
0002 A 

l-PSQRT 

FRSLJB 

0001 

F-l 


The 

following  is 

the  batch 

LIBR.OBJ. 

This 

batch 

stream  is 

i:  .10 ft  i..n 

i:  i' • »::•  rp 

ftl...  HI  1 

1 . 1 .1  .1 

y K ft  » 

«•  V 1 5.  1 

'0  ftp,  lift 

1 y !..  1 , 

ft!  D « ! 

J.  , ftl.  (1*1  J 

ii- > .1  .,  ft  1 D < 

I I A DM  A 

ft , OBJ 

y Si'll  HI  III, 

IM  ftl  ft-- 

Pool  1- 

• , OB  J 

• P'OAI  BL. 

u i-ftlju: 

1 (ft. ’Hi 

R - 0 ft  I 

. OFCFNS , 

III  i HI,  ft: 

1 ft. .'Do 

,0ft  I- 

IftA  U -'AS  , i. ) 

10  . ..  .i  .n..  f it 

i 1 ft!-' 

i-  p 8 -.r: 

, 1 1 ft  | ., 

* -ii:  :uk , oft 

IP  i ft",  lift 
h : p .I  P 

.KiL  1 

, ft!  ft  y 

i . , ft!.  D y !. 

• i 1 .ft!.,  ft., 
lip  1 i'l  1 H|-l 

1 , ftl 

ft  , l„  i , 

ftl  II..  1.4,  ft 

ft  ,.J y ( RNFTN  * Oft ,J  » I I 1 8 P . OftJ  » Cut'll-'  1 1 , Oft  I 
ft J. SPAM F 2 » Oft.) !■  PAkPOR  , Oft  ! r I f.MDl-'  I .OftJ 


ft  J - CRI..00  , OftJ  v SOI 


i'  T , Oft  I y OP  I I.  r'il . Oft.  I 
■ ( ! | , i i ft  I ...  | i j 1 1 , 0 ft ,.]  7 HI.  X f:' . ill  ft  -.1 


APPENDIX  G 


SYSTEM  BUILDING  BATCH  STREAMS 


This  appendix  contains  listings  of  the  batch  streams  and  the  overlay 
descriptor  files.  These  are  all  used  to  build  the  image  processing  system. 
Two  versions  of  the  batch  streams  are  available.  The  first  builds  the 
system  without  the  ODT  routine.  This  version  of  the  system  is  used  for 
normal  user  appplications.  The  second  batch  stream  includes  ODT  at  the 
expense  of  a smaller  buffer  area.  This  version  should  be  used  only  for 
debugging  because  it  executes  more  slowly.  Both  batch  streams  call  the 
common  batch  stream  "IPSBLD.BAT"  to  link  the  option  overlays. 

The  following  batch  stream,  which  is  stored  in  "IPS. BAT",  builds  the 
system  without  ODT: 


$ job  ipstu  • .1.1. if  kb: 

Mi  I < PIP 

i:  I P S < I. . D 0 y i:  P 8f  HA P .» .1  P S • S T B / 1 1 E 
4>R  LINK 

1 1 ps » :i. ps  » dk  : ips  * s r b< :i: pb  . odl/hp/b  : 35700/ 0 

II E X T S C T I-  R E c 0 R 5 1 0 4 0 0 0 t S E T F R E C 0 R A ) .1. 7 K 

#BBI..I:iEF"C:BIZE:  42000  fS.I/E  OF  ERECOR  IN  WHS  * 

*GBL»EF«CSIZE2: 104000  fSIZE  OF  EE EGOR  IN  BYTES 

t 0 B I... D E F “ D E I-" D 0 1 15270  » DEFAULT  BE.O  ♦ DK  J 

* G B i...  B E E !( i E F II N : 1 » *'  E E A U L.  I U N I T --  1 

*/E 

$ C U I PS BED. BATE. I 1 » 1 1 T 
l !-  .1  N I.  SH 


The  following  batch  stream,  which  is  stored  in  file  "IPS0DT.BAT", 
the  system  with  ODT: 

# $ j o b i p e o n r e 1. 1 f 1 1 :j  . k b : 

$R  PIP 

# I P S « L D A y I P S . H A E‘  f .1.  P S y S ) B / 1*  E. 

$R  LINK 

# i p s y i'  p s y n k : :i:  p s * s r b < i p s o n r . o n i...  / m p / b : 3 a 1 00/  0 

# EXT8CT  «FREC0R : 7700Q  y SET  ERECOR  AT  16K  - 250  < 

♦OBLDEFaCSIZE: 37400  5 SIZE  OF  F RECUR  IN  WHS ♦ 

* G B L IIE: I- ~ C S I Z E 2 : 7 7 0 0 0 ? SIZE  OF  ERECOR  I N BYTES 

#6BLDEF==DEFD0  J 15270  y DEFAULT  DEO . ~ DK i 

II 0 B L D E F ~ D E FUN : .1  » D E F A IJ I... T U N I T --  1 

# / E 

1>  c;  H I P B B L.  D « B A ■ I E 1 1 y 1 1 J 
*F  I NISEI 


The  following  "change"  batch  stream,  which  is  stored  in  file  "IPSBLD.BAT", 
is  called  by  both  of  the  above  batch  streams: 


> | . i if  A . 0VR002  > I 
I ! lip,  y I 1UR0O  / > I. 

. I.  I : > v l I ' • | < ' I 2.1 

■s  I i i A » UUEO  I - 1. 
* I.  . EDA  y O'  'EOO * ! 
v,  *1.  OA  » 00K027 , 1 
. |.  ...  I.  .(.  A - OUR 032  - 1 
: <:•  » I...  if  A y 0UE037  , I 
l ! .,  i DA  - 0VR042 , 1. 

I , . , | II  - , y IJVR04  ? y I. 


1.1  A y OUEOD3 ♦ 1...DA  « 0UE004  - 1 
DA  y OUEOOS)  . l ...DA  * UUE009  * I 
II A » I..I1  'RO  ! 3 . I .DA  * O'JRO  I 4 . 1 
DA  y l i'.lR'  l 1 8 - I.  ( i A “ LIAR 0 I 9 - I 
1 1 A y 0‘  K028  . I ..DA  - 0UE024 . 1 
DA  . Ob  R 0 28  - 1..  DA  » DDR 029  * I 
D A y I J U K 0 j . I ..  D A y ( .1 U k 0 A 4 . 1 
Da  y 0MR0A8  y I...  DA » OURo  P/ „ | 


D A y l .1 U K 0 .:>  3 , 1 ..  D A y I .1 0 R 0 A 4 . I. 
DA  y (40R088  y I...DA « OURU  V;'  * I 
DA  y QURU43  - I...DA  y 0UE044  . 1. 
D A v i ) U R ()  4 8 y !...  D A y 0 U R 0 4 9 y I. 


. BA y OUR 005 

» L 

DA  - Hi 

...BA  y i lURO  1 0 

* L 

DA/  t il 

I I;  | y I.U.'RO  1.5 

DA/DI 

..DA  y 0UR020 

DA/  .01 

DA « OUR 02 5 

♦ 1 

DA  / D 1 

DA » 0UR030 

DA  ' .HI 

..  (i A * 0 U R 0 :> b 

» i.. 

DA/  Dl 

DA  y UUK'040 

* i.. 

DA  / 01 

...DA  « OUR  A 45 

» i.. 

OA/LCH 

...DA  y i iUR05<» 

* i.. 

1 1 A / Cl  I 

.1 1 ‘..ii :•  io  i /(  ( i ■ 

il  00 R 002/00  ; 

tooRoo  3/00 • 

i|. i I'.'RAA-'i/Oi.i 
il  i iOROpS  /CO  -• 

| i U ROD  A /CO--: 
:■  00R0A7/C0-: 
;j  0 {;  R A 0 8 ./  O ■: 

*(iW009.'  l;o-: 


f I 8 - 8 
1. 1"’  8 y S> 
! PS  y !:> 
|.  PS . S; 


J B y 0 I 1“  .1. 1 ..I::,  y I...  ,1.  .DR/  ) v 35  /('.'()/ C 

T B y A R Si  I...  C I"  y I i B R / I l 3 5 7 0 0 / I: 

I R y 0 0 M R i:  M y I . I B R / I t 3 5 7 0 1 > / 1 

"i  0 y 8 P H T A S y I Li  B !■'  - T ; 3 5 7 0 0 / U 


TOUR 

0 i 0/00 < 

y S>  I'D 

* hOBKILI 

y 1... 

1 DR/ f i 35700 /L 

T 0 ' > E 

o i.  :i.  /co< 

I PE 

, Si  1 B 

y DEC  1 11  * 

1.  .1. 

BR/ 1 J 35 70 A/E 

II  OUR 

• : 1.  ?/C0< 

1 PS. 

- S T B 

y ,D  I T F.  iC 

y i... 

1 BK/  Y ’ '35700/E 

il-liUK 

A|.3/CCi-: 

.1.  PS 

y S 1 B 

y R 1 I.l  li-r 

y !.. 

I BR/T 1 85700/E 

>1  i J • 1 1 ■ 

0.1  4/C0< 

TPS 

, S TB 

y ! 1::.  K D 

y 1 

.1.  BR/  1 . 35700/IL 

ITO'.'l- 

o :l  5--(0 

i PS 

y STB 

y CiAl.  USE 

/ i 

; 85700/E 

i !b-‘: 

0.1.  6/C'O  : 

I PS 

- Si  B 

y DILI..  IE  T 1. 

/T 

J 35700/IL 

#00R0:l.7/  CO 
■ll-OUROIB/CO 
#(  lURO.I.  9 /'CO 
*ClUE020 /CO 
#0UR02 1. /CO 
ifi  )UR023/ C:  i.l 
11AUIV117.5/1  11 

10  1 OR  02*4 /CO 
H--00R025/C0 
(ii  (0RO2A/C0 
tOOR  027/0,0 
*001  A) 28  /CO 
:0  iO R 02 9/ CO 
*i)0R030/C0 
#1. 10R03  I /CO 

11  1 10R032/C0 
* i 1 OR 03? /CO 
0 1 1 UR 03 4 /CO 
I o OK 03 5 o,0 


DUR005  y 0 1.1 1... . - j i l -•  / 1 : 35700/E 

I PS  . H i R » 01  U...  CY/T  i 35 700/ E 

! I PS  y STD » ILL  CliNG  y I...  i BR/T  ; 35700/  L 

; 1 p s y s 1 R y n a r m 1... >:  yi.  i b r / t i 3 5 ? 0 0 / e 

I I - s y S I H * S H I E i :i: . I..  1 b R / T * 3 5 7 0 0 / L 


. :i:  P S y S T B » R E N A 0 IL  / i 1 3 5 7 0 0 / IL 

. :i:  p s y s t b y i...  o o o o e / is  3 5 7 o < > / l: 

.TPS  » S l"B  * ODDI.  D * 1..  I BR/T  ‘ 35700/E 

:i:  ps  » s iB » pun...  i.  nr  v i...  :i.  br/t  s 35700/ e 

! I • S , S r B y S T H H h 0 y L 1 B R / T t 8 5 7 0 0 / E 
T R S . S T B y W f D S M 0 » I...  I B R / T i 3 5 7 0 0 / E 
.1.  PS  . s ) B y P I ED  ill:  y I T BR/T  $ 35700/ IL 
i: P , STB  f L I N E S » L I B R /TJ  35700/ E 
l P S y S T B y I i:  I I y 1 . 1 B R / i : 3 5 7 0 0 / E 
I PS y STB y CL CO y I 1 BR/  T : 35700/E 
I R 8 , SIB.  L.  I-'  H D C P . L I B R / ! I 3 5 7 0 0/L 
IPS . STB . 0 IRCTY . L I BR /T : 35700/E 
.1  PS , STB  . HADXFM  r L I BR/T  ? 35700/E 
OUR 030 . OBI../  MP/  T J 35700/E 
I L’  S , S T B « D I C 0 M B y 1.  I B R / T l 3 5 7 0 0 / L 
TPS  .ST  B y OK  i EXT  y I I BE  / T : 35700/IL 
TPS  . STB  . FLTMUI... . I T BR/T  1 35700/ E 
.1  RS  ..  STB  . C T F 1. 1.  IL  . I.  I BR/  I i 35 700 /E 
I.  p S . Li ) B * ) A P E / I . 5 7 0 (.*  / L 
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# 0 V R 0 3 6 / C 0 < I P S . S T B » K E Y A R A , L.  I B R / T : 3 5 7 0 0 / E 
*0UR040/00< IPS . STB » SELOGF  • L I BR/T  J 35700/E 
* 0 0 R 0 4 1 / C 0 <.  I PS . STB  , KENCOO  r I...  I B R / I J 3 5 7 0 0 / E 
* 0 0 R 0 4 2 / CO < 0 0 R 0 4 2 . ODL/MP/  I .* 35700/E 

# o u r o 4 3 / c o < i p s . s r b » e o a i...  i.i  r • i...  i b r / 1 : 3 5 700/  e 

# 0 0 r 0 4 4 / c 0 < :i;  I-'  s . s r b » s e l n 0 b / r : 3 5 7 0 0 / e 

# O V R 0 4 5 / C 0 < I!  P S .STB,  3 E L 0 E C • L..  I B R / T i 3 5 7 0 0 / E 

# o o r o 4 6 / c o < :i:  p s . s r b » e e t b o l.  , l j:  b r / r : 3 5 7 o o / e 

♦0VR047/CCK  1 PS  , S I B , RGSTAT  » L.  I BR/T  i 35700/E 

# 0 V R 0 4 8 / C 0 < 1 1::'  S . S T B , C R E U E C » I...  J B R / T i 3 ‘::i  7 0 0 / E 
#00R049/C0<  I PS  . STB » GRESES  , I...  I BR/T  1 35700/E 

# 0 0 R 0 5 0 / c 0 < I F:‘  S . S T B , D E C I M G , L I B R / I 5 3 5 7 0 0 / Ei. 


The  following  is  the  overlay  descriptor  file  "IPS.ODL"  which  is  used 
in  building  the  system  without  OCT: 


□or  o:i. ; 

, ECTR 

F I LEI. 

i I0R02 : 

. FCTR 

F EI...E2 

00R03 ♦ 

. PC  I R 

F II...  E 3 

00 RO 4 ; 

. 1-  C IR 

F ILL  4 

MAINS 

, l::  C I R 

p i . o t --  i r y :i:  o - t e i...  e :i.  o - s a u e r - s a r f p s b l : 

.1 ISP-I 

. ROD  i 

H A I N ••••  F T N 1 I B - Jfc  < 0 U R 0 1 v 0 U R 0 2 0 V R 0 3 » 0 

IR04  > 

, END 

The  following  is  the  overlay  descriptor  file  "IPSODT.ODL"  which  is  used 
in  building  the  system  with  ODT: 


The  following  is  the  overlay  descriptor  file  "OVR030.OBL"  which  is 
used  in  building  overlay  "OVR030 . ODL" . 

< i'  - 1 1 : .iiii-'  ii  it  ip  J l ! | i-<R 

' i'  1 ' • ■ • l !•  ii  I i il  ri  1 PA'.P  I- PmjRI  -P.xP  - | .1)1 , - 1 ; y '■ iifi  -IV  mil  - AS 

t l ill'  1 1 - ' I H - I I 'I  Pi  I 

ini'  j i i-i  I- 1 n*  1 1 ■!  i jup02  • 

• i.Hi 


The  following  is  the  overlay  descriptor  file  "OVR042.ODL"  which  is  used 
in  building  overlay  "CVR042.ODL". 


» * * • K • ■ I x M IP  UK ''hi  A 
: 1 » t ■ ' < > ' ! i ■ I i I-  | r i 1 1 M A !" 

. i |-  pM  -j-  | . I » 1 1 | l ‘i  1 1 , i - 1 — ■ l i i;  l | v.  I j i-i  i t » - • I ;-ii  IVI:  • > - 1^1  I II  I I A -I- 1 ' .1  >1  ' 

> 1 1 ri-  '■> . s i h -i’'ii  i (ri  - f 1 i iP'PO  | j i'/pi ' ■ 


APPENDIX  H 


SYSTEM  MACROS 


This  appendix  contains  a listing  of  the  system  macros  which  are  stored 
in  file  "MACS. MAC".  When  a program  references  any  of  these  macros,  this 
file  must  be  specified  as  the  first  input  file  in  the  assembler  command  line. 
The  following  is  an  example  of  its  use: 

DK: ,LP:  < MACS, PROG 

where  the  file  "PROG"  is  a program  that  references  one  or  more  of  the 
system  macros. 

The  listing  of  MACS. MAC  is  as  follows: 


; | his  |"  Vi  .I.  i'i.  ir)  T A INS  ALL  THE  GENERAL  MACRO  DEFINITIONS  FOR  THE 

i I MAGE  PROCESSING  SYSTEM, 

V LISTING  of  hie  macro  definitions  is  suppressed  throughout 


y 1 III 

8 FI 

IE, 

v -v/ 
.•  i'  • . 

:***:•! 

t Jk  Y Y % -t~ 

:{'  # if  % 1 1 # t * t * t * * * * * % * * * * * * * * * 1 1 * * * % t * * 1 1 1 * 1 1 * * * 

« ill  1 

S MA 

CRD  ES 

I API  I 

S H E S T 1 1 E 8 Y S T E M P A R A M E T L R S 

. MACRO 

SYS 

(EM 

5 THE 

E 01. 

1.  OWING 

DEFINES  THE  FIT 

■ST  THREE  CHARS,  OF  AN  OVERLAY  NAME 

QVRMaM 

5 6 7 0 Of  1 5 6 0 !■  2 2 

ii  01  V t R (RAD  50) 

PI  HE 

101.. 

L OWING 

PETE 

RMINLS  THE 

DEVICE  ON  WHICH  IPS  RESIDES 

S YDEV= 

73300 

Cl  750 

JSfY  ( RAD50 ) 

y THE 

POL 

LOWING 

HE  11: 

R MINES  THE 

UNIT  ON  WHICH  IPS  RESIDES 

I.INI  TNG 

rO 

5 UN IT  0 

i THE 

EOT 

LOWING 

METE 

RM INES  THE 

USER  NUMBER  UNDER  WHICH  OVERT.  AYS 

i ARE 

SEA 

R CHILD , 

IPSUI D 

= 441 1 

i U 1 D~  1. 1 y .1. 1 

, ENDM 

SYS 

(EM 

« 


•It***********##*****#***#***#***#*###**#*#**********#**#*#******** 

HIE  MACED  F.EEQ  GENERATES  THE  FILE  REQUEST  BL.DCK  FOR  ALL 
F 1 1 E F 1 1 NC  i I 0 N S . I H E P 0 S S I B L E A E G U M E N T S A E E 2 

I..  Rl  -LABEL  PREFIX 

i HE-AuE  OF  CHARS  STRING  ( O-NAME  SUP  PI.  I EH  IN  REQUEST  ME) 

F ■<:  I F 1 1.  E F X r E N S 1 0 N ( D A T A I Y P E ) 

EEC 8 -TO  i'AI.  NO.  OF  RECORBS 

l iv  i « r t c o r n i...  e n g t h ( B r r e s > 

ACES -ACC;  ESS  TYPE 
.1  -El  AD 
HR  T TE 

.2 --MUD  I FY  (E/W  ) 
i l VI- -I  I LE  TYPE 

0 - CONTIGUOUS 
1 .-LINKED 

ETYP-EECOED  TYPE 
A -FIXED  LENGTH 

1 - -VARIABLE  LENGTH 

NAME -I-  II..  E NAME.  THIS  AEG.  MUST  BE  LEFT  BLANK  IF  NO  NAME 
IS  GIVEN. 


THE  CALL  FORMAT  FOR  THE  CREATE  FUNCTION  IS  2 

F . E E Q 0 « I...BL  f C H R i E X T,  R E C S * I . N G .<■  A C E S y F T Y I"'  r E T Y P y N A M E 

THE  CALI  FORMAT  FOE  THE  RE  TE  IF  UF.  FUNCTION  IS  2 
I . E E Q 1.  1 1...  B I.,  y C 1 1 K'  y I::.  X I y A (.2 1-  S y N A M I: 


» M A C E 0 F . R E Q A I y A 2 y A S » A 4 y A b y A A y A / r A S y A 9 » A 1. 0 
.IF  EQ  All  5 CREATE 

I-  , E E Q 1.  A 2 y A 3 y A 4 y A 5 y A 6 * A 7 y A 8 «•  A 9 y A 1 0 
, M E X I T 
. ENDC 

.IF  EQ  A 1-1  y RETRIEVE 

F , R E Q 1 A 2 y A 3 v A 4 y 0 y 0 y A 5 y 0 y 0 * A A 
. HEX. IT 
. ENDC 

. F MOM  F.EEQ 


"V'f*******#***^*#^**##***#*##*#******#****^**********^************** 

• HIE  MACRO  F.REQ1  IS  CALLED  BY  F.REQ  TO  SET  UP  THE  REQUEST  BLOCK 
. MACRO  F . REQ  t A * B . C . D . E . F . G . H . I 


A ' CHR : 


.WORD 
. IF 
. I FT 


B 

NB  » I 


5 ADR  OF  OUTPUT  CHAR  STRING 


A ' NAM : 

. RAD SO 
. NCHR 
. I IF 
. IFF 

/.I/ 

F . CHR 3 * I> 
LE  » F . CHRS-3 . 

f FILE  NAME 
.WORD  0 

A ' NAM t 

.WORD 
. LN  DC 

0.0 

.FILE  NAME 

a ' p < i : 

. RAD50 

/c/ 

JEXTENS ION 

10  SHOW  DATA  T 

A ' DE  V : 

. WORD 

0 

. DEVICE  IN 

RAD50 

A ' IJN  T : 

.BYTE 

0 

; un I r no . 

A' rip: 

.BYTE 

<4*F>+<2*G>+H 

.RECORD.  FI 

_E  AND  ACCESS 

i BIT  0=0  - FIXED  LENGTH  RFC. 
; -1  - OAR.  LENGTH  RFC 

f BIT  1 = 0 - CON  TIG.  FILE 
5 =1  - LINKED  FILE 

! BIT  2=0  - NO  READ 

i =1  - READ 

*.  BIT  3=0  - NO  WRITE 


A' due: 

. WORD 

F RFC OR 

i =1  - WRITE 

5 BUFFER  ADR. 

a'siz: 

. WORD 

C SIZE 2 

5 BUFFER  SIZE  (BYTES) 

A • CNT ; 

. WORD 

D 

f TOTAL  NO.  OF  RECORDS 

A ' LEN : 

. WORD 

E 

i RECORD  LENGTH 

A ' CON ■ 

.WORD 

1 

i NO . OF  CONTI  13.  RFC.  REQUIRE 

A ' RFC : 

.WORD 

0 

»REC.  NO.  REQUESTED 

. ENDM 

F . RECTI 

>***-Tt****#********#*****)|t*!K*!t:**!K#*)|!»i|t*****3K*iK*********!|c3|t********:|!.»:1c*!»!lr*!(t 
i THE  F.CRE  GENERATES  A SUBROUTINE  CALL  TO  CREATE  AND  OPEN  A 
» FILE  FOR  I/O.  THE  HEADER  WILL  BE  ESTABLISHED  IN  CORE  BY  F.CRE. 

• ITS  ADDRESS  WILL.  BE  RETURNED  IN  RO. 

5 ADR = A DR  OE  REQUEST  BLOCK  (1ST  WO) 

s A I IRE 1= ALTERNATE  RETURN  ADR.  WHEN  CR  TYPED  (OPTIONAL) 


. M A C R 0 F . C R E A D R.  ALT R E T 
J3R  R5. F.CRE 

. NARO  X** 

DR  ,+<2*X$$>+2 

• NL 1ST  CND 

. 1 1 L NB  ADR » .WORD  ADR 

, I IF  NB  ALTRETf  -WORD  AL.TRET 

.LIST  CND 
. ENDM  F.CRE 


H-3 


.;****  it**  **********************************  *******  *********************** 

i i HE  MACRO  F.CRE*  GENERATES  A SUBROUTINE  CALL  JO  CREATE  A FILE, 
s Tin;  III- AUER  WILE  BE  ESTABLISHED  IN  CORE  AND  If)  ADDRESS  WILL  BE  RETURNED 

. KO 

i ADR "ADR.  OF  Rh GUEST  BLOCK 

. AL  (RET-AI ...TERNaTE  RETURN  ADR  WHEN  CR  TYPED 

. MACRO  F , CRET  ADR  . At.. TRE  T 
ISR  R5 1 F . CKET 

.NARG  XT* 
uR  . •K2*X**.>+2 

, NI..ISJ  CND 

.III  NU  ADR  t .WORD  ADR 

. I 1 F N B A L T R E T » .WO R D A L T R E T 

.LIST  CND 
. EN.0M  l-.CRET 

.flit  * * * ***  * * # * * * * * * * * * t * ****  * * * * * * % * * * * % % % ******  * * * * * * * * * ********  * * * * * * 
y I HE  MACRO  E.RET  GENERATES  A SUBROUTINE  CALL  TO  RETRIEVE:  AND 
i OREM  A FILE  FOR  I/O.  THE  HEADER  WILL  BE  READ  INTO  CORE  BY  F .RET . 

.ITS  ADDRESS  WILL  BE  RETURNED  IN  KO. 
i A DR- A DR . Of  REQUEST  BLOCK  CIST  WORD) 

Al.  I RFT-AI.  JFRNATE  ADR.  WHEN  CR  TYRED 


. MACRO  E . RE  T ADR . AL I RE  I 
ISR  R5»  E.RET 

.NARG  XT* 

BR  . t<2*X*#>+2 

. NT.  1ST  CND 

, I II-  NH  ADR  i .WORD  ADR 

, 1 1 F N B A L.  T R E T . . W 0 R D A L T R E T 

.LIST  CND 
. ENDM  E.RET 

; *********************************************************************** 
i THE  MACRO  F . RETT  GENERATES  A SUBROUTINE  CALL  TO  RETRIEVE  A FILE. 
iTI-IE  HEADER  WILL.  BE  ESTABLISHED  IN  CORE  AND  ITS  ADDRESS  WILL.  BE  RETURNED 
i I N RO. 

i ADR -ADR.  OF  REQUEST  BLOCK 

. AL I RE  T= ALTERNATE  RETURN  ADR  WHEN  CR  TYPED 


• MACRO 

1 , RE  IT  ADR.  At.  TRET 

JSR 

R5.F.RE T* 

.NARG 

XT* 

BR 

, T ■:'2*X**:"  f 2 

. NL.  IS  T 

CND 

. 1 IE  ND 

A T i ft  » * Ul  0 R D 

4 1 IF  NR  At.  I RET  * .WORD  AL.TRET 

.LIST  CND 


•ENDM  F . RETT 


; ******************  *******  *****  *************************************; 

i THE  MACRO  F.CHK  SEARCHES  FOR  A FILE  TO  DETERMINE  WHETHER  OR  NOT  IT 

i EXISTS*. 

i A DR “ADR . OF  REQUEST  BLOCK 

y NOFILE*RETURN  ADDRESS  IF  FILE  NONEXISTENT 

y 

.MACRO  F.CHK  ADR. NOFILE 
JSR  R5» F.CHK 

BR  . F6 

.WORD  ADR  i REQUEST  BI...K . ADR. 

.WORD  NO FILE  » RETURN  ADR.  IF  FILE  NONEXISTENT 

, ENDM  F.CHK 

i ********************************************************* **********> 

; ( FI  E M A c R 0 F . D E L G E N F.  R A T E S A SIJ  B R 0 U 1 1 N E C A L L 1 0 D E L E I E A 

f I"  .1. 1...  I::.  . 

f ADR™ ADR  OF  DUFFER  WITH  LINK  AND  FILE  BLKS 

y NOFILE “RET  URN  ADDRESS  IF  FILE  NONEXISTENT.  FATAL  IF  0. 


.MACRO  F , DEL..  ADR.  NOE  II.  F 
CALL  F. DEL.  ADR.  NOFILE 
.ENDM  F. DEL 

y ****************************************************  ***************){ 

■y  THE  MACRO  F'.RNM  GENERATES  A SUDROU I INI  CAM.  TO  RENAME  A FILE. 

5 ADR-' ADR  OF  BUFFER  WITH  LINK  AND  FITE  BI.KS 

i NOF  I I..E “RE TURN  ADDRESS  IF  FILL  NONEXISTENT.  FATAL  IF  0. 

» DOPE  IT  ..“RETURN  ADDRESS  IF  DUP.  FILE  NAME.  FATAL.  IF  0, 


. MACRO  F , RNM  ADR  . NOF  I L E - Dl  IPF 1 1 
CAL  I...  E . RNM . ADR  . NOF  I L.E . DUPE  I L. 

.ENDM  F.RNM 

. *******************************************************************: 
i THE  MACRO  F'.PTR  GENERATES  A SUBROUTINE  CALL  TO  RETRIEVE  THE  CORE 
SADR.  OF  A GIVEN  RECORD  OR  RECORDS.  THE  ADDRESSES  ARE  RETURNED 
y ON  THE  STACK,  THE  FIRST  RFC,  ADR.  IS  ON  THE  TOP  FOLLOWED  BY 
y THE  REMAINING  RFC.  ADR'S.  IF  ANY.  NOTHING  IS  RETURNED  IF  THE 
y R E C 0 R 0 I S N 0 N E X I S T E NT. 

. A DR “A. DR  OF  REQUEST  BEK  (1ST  WD> 

r F!  R F!  0 R - R E C 0 R D N 0 N E X I S T E N T 

y 

.MACRO  F'.PTR  ADR. ERROR 
.NARG  .SYM 
.IF  EQ. .SYM -2 

CALL.  F . PTR . ADR » ERROR 

, hex  :i:  t 

- ENDC 

.ERROR  , SYM  y ILLEGAL  NO,  OF  ARGUMENTS 

.ENDM  F.PTR 
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, a.t*t*^******* ************************************** t *************** ^*** 

THE.  MACRO  F.CLOS  GENERATES  A SUBROUTINE  CALL  TO  CLOSE  A FILE 
ADR-ADR  OF  REQUEST  HI  k LIST  UD) 


i RE.O  . HI  K AMR. 


* MACRO  F.CLOS  AHR 

Jsk  RS. F.CLOS  » CLOSE  A FILL 

HR  ,14 

.WORD  AHR  5 RE  G . HI  K AHR. 

. ENDM  F.CLOS 

f ***:******************************************************************  ** 

) THE  MACRO  F .SHUT  GENERATES  A SUBROUTINE  CALL  TO  CLOSE  ALL  FILES 
• L URIC  I NLLY  OPEN. 


.MACRO  F . SHUT 

CALL  F . SHUT  i CLOSE  ALL.  OPEN  FILES 

. ENDM  F . SHUT 

s I:********:**:*************.*************:******************  ******  ******** * L 
« THIS  MACRO  EXTENDS  A F ILE  BY  A SPECIFIED  NO.  OF  BLOCKS 
. AHR  •ADR.  OF  REQUEST  BLOCK 

i EX  I END - ADR . OF  EXTENSION  IN  25A  WD.  BEKS. 


. MACRO  F . EXT r ADR  r EXTEND 
JSR  R5.F.EXT 

HR  .16 

, WORD  ADR  # REQUEST  BIK.  ADR. 

.NO  R D E.  X T E N D i E X T E N S 1 0 N 

. ENDM  F .EXT 

f * * * * * * * *****  * * * **********  * * * * * * * :*  * * * :*  * * * * * * * * * * * * * ********  * * * * * * * :!  * * * * i 

i THE  MACRO  CALL  GENERATES  AN  EXTERNAL  SUBROUTINE  CALL  WITH  UP  TO 

?s:rx  parameters. 


. h A ( R 0 C A I L N A M »P1 . P 2 t P 3 » P A . P 5 • P 6 
. NARG  X$$ 


.ISR  Rhrf 
.IF  NH  F 

HR  . 1X1 

. E.NDC 

. Nl.  1ST  CND 
. I IF  NH  Pl> 
.HE  NH  P2 r 
. I IF  NH  P3 f 
. i J F NB.P4. 

. I IF  NH  P5» 

. I IF  NH  PA» 
.LIST  CND 
.ENDM  CALI. 


R 1 j . NAM 
NH  PI 
. IX  * * IX  1 $ 


, WORD  PI 
. WORD  F'2 

. WORD  P3 

. WORD  P4 
. WORD  P5 
.WORD  PA 


> 


******************************************************************* 

THE  MACRO  ER.FAT  GENERATES  A CALL  TO  THE  ERROR  REPORTING 
ROUTINE  FOR  FATAL  ERRORS. 

N l .)  M - F A I A L E R R 0 R NO  MR  E R 


.MACRO  ER.FAT  NUM 
JSR  R5.E.ERR 

BR  .+4 

.BYTE  NUM  f FATAL  ERROR  NUMBER 

.BYTE  1 » FATAL  ERROR 

, ENDM  ER.FAT 

! ******************************************************************* 

i THE  MACRO  ER.REC  GENERATES  A CALL  TO  THE  ERROR  REPORTING  ROUTINE 
IFOR  RECOVERABLE  ERRORS 
’ NUM-RECOUERABLE  ERROR  NUMBER 


, MACRO 


JSR 

R5 . E 

BR 

. f 4 

.BYTE 

NUM 

.BYTE 

0 

.ENDM 

ER.R 

ER.REC  NUM 
R5  » E . ERR 


i R E C 0 U E R A B L E E R R 0 R N U M B E R 
f RECOVERABLE  ERROR 


: ******************************************************************* 
THE  MACRO  MACS  DEFINES  THE  , MCALL ' S'  FOR  ALL  MACROS  IN  THE 


i DUS  SYSMAC.SML  F 


.MACRO  MACS 

. M C A L I...  . P A R AM..  I M I T . . R I...  S E . . C I...  0 S E . , R E AD.  -UR  I T E 

. MCALL  . OPENO . .OPEN I . . OPENU . .OPENCx .OPENEr .WAIT. .BLOCK 
. M C ALL  . W A I T R » . T R AN.  .8 1’  E C.  .STAT.  .A  I...  L 0 C . . D E L ET.  .R  E N A H 
. M C A I.  L , A P P N D . , L 0 0 K . . K E E P . . E X I T . ♦ T R A P ..SI  F p U . . R E C R D 
. MCALL  . DUMP . . RSTRT . . CORE . . MO NR . . MONF . . DATE . , T IMF 
. M C A I...  I...  , (3  I U I!  C » . S Y S D 0 . . R A 0 P K . , R A D U P . . D 2 BIN.  .BIN  2 D . . 0 2 B I N 

.MCALL  . BIN20 . .CSI1 . .CSI2.  » DTCUT  . . TMCUT  > , OUTDT  . . STPL.A 
, M C A LI  . G T P L A . . D T C I V . , G T S T K . . S T S T K . . R U N . . F I.  U S H . , 0 P E N 
.MCALL  . GTEDV . .GIOVF 
. ENDM  MACS 

i ******************************************************************* 

•5  THIS  MACRO  DEFINES  THE  FLOATING  POINT  REGISTER  MNEMONICS. 

.MACRO  REGS 
A CO  "/SO 
AC  1 ■■■  X :l. 

AC2SS%2 

AC3"%3 

AC4---X4 

AC5*X5 

.ENDM 


;*t*l*t%**it*tt**tt***if.*xx**t+t,+*ttt****>lr  *********************  ************ 

* MACRO  FOR  DEFINING  LINK  BLOCK 


.MACRO  l.NKBLK 
i LINK  BLOCK  DEFINITION 


CHR ' L NB t 
. I IF  RfLDNf 
. I IF  NBfLPN. 

• BYTE 
. BYTE 
. IF 

. I IF  B RUN. 

. IJF  NB  FUN.. 

.ends 

.LIST 


CND 
RET 
0 

. RAD 50 
. RAD50 

NUI  J F 
ON 

EQ  t NWTF  - 1 
. RARtiO 
. RAD50 

CND 


. Nl..  1ST 
. WORD 

. WORD 


CHR . RF I r LDN » NU  T F f UN  f PDN 


i ERROR  RETURN  ADDRESS  * 0-F  A T At. 

fLINK  pointer 

/ / ;no  logical  namf 

/LDN/  fLOGICAL  DATASET  NAME 

J NUMBER  OF  WDS  TO  FOLLOW 
fUNIT  NUMBER 


/ / f ASSIGN  MUST  BE  USED 

/PUN/  » PHYSICAL  DATASET  NAME 


. ENDM 

« j*********************************************************************** 


i THIS  MACRO  DEFINES  FILE 
.MACRO  FIT.  BLK 
» FILENAME  BLOCK  DEFINITION 
.NL 1ST  CND 
.WORD  RET 

.byte:  ho 

CHR'ERC:  .BYTE  0 

.IF  NB  f Fit.  NAM 
, IFF 

chk-'fnb:  .word  OfOfO 

. TF  T 

CHR'FNB:  . RAD’50  /FILNAM/ 
.RADSiO  /EXT/ 

. ENDC 


.WORD  U.IC 
.WORD  PC 


NAME  BLOCKS. 

CHR f RE T f HO . F I L N AM  f EX T f U 1 C f PC 


f ERROR  RET.  ADDRESS f 0~F  AT Al 
• HOW  OPEN  CODE 
f ERROR  CODE 


fFIL.E  NAME f EXT  NOT  REQUIRED 
ill  I E NAME 


fUSER  id  code 
F PROT  ECT  ION  CODE 


.LIST  CND 
. F NDM 

ft **************************  **************************************** 
f THIS  MACRO  DEFINES  BUFFER  HEADERS. 

. MAORI ) BUF  I 1 DR  CHR f MBCN I f MODE  - ABC NT t PNTR 


U 1NE  BUFFER  HEADER  DEf INI t ION 
CHR'MBCJ  . WORD  MBCNT 

.BYTE  MODE 
.BYTE  0 

CHR' ABC J .WORD  ABCNT 

.MUST  CND 
.IF  NR. PNTR 

chr-ptk:  .word  pntr 

.ENDC 

.LIST  CND 
.ENDM 


f MAXIMUM  BYTE  COUNT 
f TRANSFER  MODE 
f TRANSFER  STATUS  BYE 

factual  byte  count 


f STARTING  ADR  OF  LINE  BUFFER 
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i *******  ******  **************  ******************************************** 


i I HIS  MACRO 

DEF INFS 

TRAN  HI 

OCKS. 

.MACRO 

TRNBI.  K 

CHR  t DBN  . BIJF  R . WCN  I . F IJNC 

i IRAN  BLOCK  DEF 

I N t T 1 ON 

chR'Tnd:  .word 

OBN 

f DEVICE  BLK  NO. 

CHR  BUI  : .WORD 

BIJF  R 

r BUFFER  ADR 

CHR'CNi:  .WORD 

WENT 

» WORD  COUNT  TO  TRANSF . 

.BYTE 

FIJNC 

» FUNCTION  CODE  BYTE 

chr'tst:  .byte 

0 

5 STATUS  BYTE 

.WORD 

0 

» NUMBER  OF  WHS  NOT  TRANSFERRED 

. ENDM 

;********.*************************************************************** 

i THIS  MACRO 

DEF  I NF  S 

RECORD 

BLOCKS. 

. MACRO 

RECBL K 

CHR  ■ FI  JNC  . BUE  > RL.EN . HORN t LORN 

« RECORD  Bl.  OCK 

DEF INI  I ION 

i hr'Rcb: 

.BY  IE 

FIJNC 

f FUNCTION  CODE 

- BYTE 

0 

i STATUS  BYTE 

.WORD 

BUE 

i BUFFER  ADDRESS 

.WORD 

RL.EN 

i R E C 0 R D L.  E N G T H < B Y T E S ) 

. WORD 

HORN 

.HI  ORDER  RECORD  NUMBER 

.WORD 

LORN 

FLO  ORDER  RECORD  NUMBER 

.ENDM 

; ******************* * * * * * ****************************************** * * * * * 


I H I S h A C R 0 1 1 1'  I ■ 1 N E S It  L G C K B L 0 C K S 


. MACRO  BLKBI..K  Cl 
f M..l.)CK  BLOCK  DEFINITION 
CHk'DKB*.  . BYTE  1-1  INC 

.BYTE  0 

CHR'BNMJ  . WORD  BN DM 

♦ WORD  BUF 
.WORD  I..EN 

• ENDM 


• FIJNC  * BNIJM  y DUE  t LEN 

» FUNCTION  CODE 
i ERROR  STATUS  BYTE 
• REG . BLK  NO. 
f ADDRESS  OF  BUFFER 
f LENGTH  OF  BUFFER 


;*** *********************************************************** ********* 
» THE  FOLL OWING  MACRO  IS  USED  TO  PARTITION  FREE  CORE 


.MAC R 0 C 0 R D 2 A D D R 1 . A D D R 2 » N 0 T L 0 W 

.GLOBE  FRECOR»(.:SIZE 

EQUATE 

. Nl.  1ST  END 

•IE  B NOT LOW 

A OU  IF  RECUR  r R4 

MOO  #CSIZE»R3  i 1/2  OF  FREE  CORE  IN  BYTES 

. ENDC 

,1  1ST  CND 

B ) C * I . R 3 * F 0 R C E 1 0 W D . BOON  D A R Y 

MOO  R4 • ABDR1 

Ml  10  R3 » A DDR  1.  f S I /-DUE 

ADD  R3  r R4 

MOO  R 4. A DDR 2 

M 0 0 R 3 * A D D R 2 f S I /-BIJF 

.ENDM  CORD 2 
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0 **! (t'K*^*  ^:***^*:**:**^**^************************  ^**^**********^*****^:^**:’*:* 

f ni.!.S  MACRO  DPT  INFS  SEVERAL  IPS  PARAMETERS . 

.MACRO  EQUATE 

1 THE  I HI  LOWING  EQUATES  PERTAIN  ID  FILE  OPERATIONS 

CR  !•:>()  f CITE  A I E FIJNCI  I ON 

RLT=1  .RETRIEVE  FUNCTION 
i I HI  F 01  LOWING  EQUATES  PERTAIN  TO  ACCESS  TYPE 
KD  1 5 READ  ONLY 

WR=2  « WRITE  ONLY 

M 0 A f M 0 ) 1 1 F Y < R E A D / W R I T E ) 

. TUI:  I 0|.  LOWING  EQUATES  PERTAIN  TO  FILE  TYPE 

C 0 N T I G = 0 5 C 0 N I I G 0 1 1 0 0 S F I L..  E 

L INK  (i  - 1 f LINKED  FILE 

i THE  I nl...l. OWING  EQUATES  PERTAIN  TO  RECORD  TYPE 
F LEND)  * FIXED  LENGTH  RECORDS  ■ 

VI  T N~1  * VAR  I ADI.  E LENGTH  RECORDS 

; f HI  FOLLOWING  DEFINES  CARR A] GE  RETURN  AND  LINE  FEED  MNEMONICS 

CP'  1.5 
L.l  -3  2 

i l l-IL  1-  01. 1.  OWING  EQUATES  ARE  USED  TO  DEF  INE  OF  F SETS  IN  THE  REN  BLK 
CHR~0  i CHAR  STRING  ADR 

NAM-".?  r F I I...F  NAME 

I >,  I = 6 : 1 I L I:  E X T E N S 1 0 N 

DEV  " I 0 » DEV] CE 

UNI  “1.2  5 UN  IT  NO. 

RIP- 1.3  5 ACCESS  TYPE 

B 1 1 1 ~ 1 A i B U I F E R A D D R E S S 

SI /-I  A i DUFFER  SI2E 

CN  I -20  * Nl  II  OF  RECORDS 

I F N~22  5 RECORD  LENGTH 

C0N=24  UNO.  OF  CON TIG  RFC  REQUESTED 

REC=2A  »REC.  NO.  REQUESTED 

f 

. THE  FUL.LWOING  EQUATE  IS  USED  TO  DEF  INE  THE 
f MAXIMUM  NUMBER  OF  LINES  TO  BE  OUTPUT  BEFORE 
i I T HU  1 1 . D I NG  T HI  D I GPL  A Y 

y 

I INMAX =50. 

f 

i CHI  FOI  LOWING  IS  THE  SIZE  OF  THE  HEADER  CREATED  BY  I-  ILEOP  IN  THE 
■ir.l  R SUPPLIED  BUI  PER 
HD  RSI  7.-62 
* I..NDM  EQUATE 
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Si 

$ 


****************************M**********************  ******* 
I III-  I-  OLE.  OWING  MACRO  IS  080 > TO  MOVE  A SPECIFIED 
NUMBER  OF  BTTES  FORM  ONE  LOCATION  TO  ANO  i HER 
USING  I HE  REGIS l HRS  SPECIFIED 


, MACRO 

Hr i MOV 

FROM  . RE  0 1.  . 10.  EE : V3.CN  1 

, f NADI 

L SB 

oou 

41  ROM  » RF  G1 

Ml  IU 

# 10  v RE 02 

MOO 

IM  Nl  . REST 

MOV  >< 

< El  01  if.  ( RE 02 ) f 

So  Vi 

RE  03 . t 3 

. US,  Oil 

1 SR 

.1  N ( i H 

Hr i MOV 

XX ******* 

3 3 ! * 3 3 * # 3 3 3 3 3 3 3 3 3 

3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 3 * 3 

oi  1. 1 iki  i:ng 

MALk’0  MOVES  "IE XI" 

IN  10  1 ILF  HE  AUIRS  > 

< MACRO 

UDRTXTyADRI .ARE 2 

. A RE  3 

A I'D 

.+  384  •>  . RO 

.ADR  IN  HEADIER 

MOV 

A '.ik!  . R 1 

« ADR  OF  i'E.x  "1 

M i } V D 

( P 1 if. (R0)  + 

•STORE  IN  HEADER 

DU.' 

...  "> 

<• 

Ell  ANO  Til.  1 Mill  I 

, IF 

i r i 

NR  A OR  ? 

.1  i:  C 

l 

HACK  i 0 NO'  : 

i-iuv 

A (.1  i 2 . R .1. 

NEK I SE  C l I ON  Of  HEX i 

MOOD 

( R .1.  ) f « ( R()  .)  f 

S ( i 'EE  IN  HEADER 

DUE 
* ! 1 F 

* 2 

HANG  11  LI..  NOLI.. 

MEX  1.  1 

- ENi'h; 

, 1 F 

NB  . A DR  3 

DE  i : 

RO 

BACK  TO  Mill  1 

Mi  IV 

ADR  5 » R:l 

iMIEXI  SECTION  of  TEXT 

MO  VP 

< R ;i.  i v ? ( R<>  > ••} 

S I ORE:  IN  HEADER 

BNE 

. -2 

Ho NO  TILL  NULL 

a ENDC 

a ENRM 

H li  PC  XT 

H-ll 


* * ?.** **#* **** #*** # ****.** ***** IKK* ******** * *'**'* **** *********** 

I Ilf"  I- 01.  LOWING  MACRO  PUSHES  UP  TO  SIX  ITEMS  ON  THE  STALL  * 


. MA(  RO 

PUSH  • A .*  B . C . Vi . E . 

F 

, 1 1 

N B » A 

*-»>;)• 1 

A y • • ••  S P ^ 

v 1 ■ l l‘“.H 

ON  '• 

(A  OF 

..  e n oc 

- IF 

MB  * n 

j » K } 

1!  » • i • | I 

5 P • ) H P 

1 0 S 

PACK 

> i-  1 Jl.ll. 

1 

ML  >■  C 

ii  no 

1 - < >1  • 1 

y POSIT  l 

TO  9 

PACK 

. 1 , Mu' 

. 1 P 

r l L « ,(  . i 

1 1 1 1 o 

1 1 i S P ) 

-I'll  S |-l  A 

1 1 1 S 

TACK 

v »•  I • III  ' 

! f i : ••  l 

ill  10 

1 . - i UP  i 

» F'lJSlT  E 

l 0 3 

TACK 

, 1:  NOT' 
( I 

; IV 

NR.  I 

1 - ■ i UP  i 

5 POSH  F 

1 0 S 

I ACK 

♦ l fv»M : 

r •!'  # r )' 

Vs  ■ * * fc . ;<  X X X * X X X X X X * 

XX***.*  XX 

xxxxx 

XXX  XX 

i-oi.!.  nw 

IMG  MACRO  POPS  UP 

ID  SIX 

1 T E n 

FROM 

* r'ir«i  i 1 1 

|*  * 1 .1 1*  ‘ y m •>  i!  v 1 ’ v .(1  v | y j- 

* f 

i IB  * A 

HI  10 

( • ip  > -I- » A 

ypnp  A 

FROM 

STACK 

. I;:  MnC 

, IF 

NB  - B 

MOO 

i yp  i •}  , B 

ypl.lp  B 

FROM 

S PACK 

PM  in 

, 1 F 

NB  * C 

rioo 
, Er-mc 

< SP  ) T y C 

ypnp  C 

FROM 

S J ACK 

, l F 

NB « i..i 

MOO 

< sp > + « n 

y POP  B 

FROM 

STACK 

» 1 N OC 

, IT 

MB  •/ 1. 

ft  00 

< SI-'  > S'  h 

5 PUP  E 

FROM 

S PACK 

l NnC 

• IF 

NB » I- 

Mi  )0 

< SI-' ) + . F 

y POP  F 

F ROM 

STACK 

- EN.nC 
■ T i')  i i ii 
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, * * *****  * ********  ******  **********************************  f 
i i HI:  MACRO  LOAD  G FNFRATFS  CORF  TO  LOAD  AN  OVFRI  A Y , 

3 NUM“1  HR  li-  L CHR.  ALL  I ! SIRING  DESCRIBING  OVFRI  AY  NO. 

v I N T I - N I R Y III  i:  ill  Nn.  CANY  ADDRESS  I.  NG  MODI;  IS  LEGAL) 


. M A 1 R 1. 1 

1 DAD 

I II  HT 

y F N 1" 

ST SI FM 

y 

DEFINE 
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BASE  UNITS: 

Quantity 


Unit 


length 

mass 

time 

electric  current 
thermodynamic  temperature 
amount  of  substance 
luminous  intensity 

SUPPLEMENTARY  UNITS: 

plane  angle 
solid  angle 

DERIVED  UNITS: 
Acceleration 

activity  (of  a radioactive  source) 

angular  acceleration 

angular  velocity 

area 

density 

electric  capacitance 

electrical  conductance 

electric  Held  strength 

electric  inductance 

electric  potential  difference 

electric  resistance 

electromotive  force 

energy 

entropy 

force 

frequency 

illuminance 

luminance 

luminous  flux 

magnetic  field  strength 

magnetic  flux 

magnetic  flux  density 

magnetomotive  force 

power 

pressure 

quantity  of  electricity 
quantity  of  heat 
radiant  intensity 
specific  heat 
stress 

thermal  conductivity 
velocity 

viscosity,  dynamic 

viscosity,  kinematic 

voltage 

volume 

wavenumber 

work 


metre 

kilogram 

second 

ampere 

kelvin 

mole 

candela 


radian 

steradian 


metre  per  second  squared 

disintegration  per  second 

radian  per  second  squared 

radian  per  second 

square  metre 

kilogram  per  cubic  metre 

farad 

siemens 

volt  per  metre 

henry- 

volt 

ohm 

volt 

joule 

joule  per  kelvin 

newton 

hertz 

lux 

candela  per  square  metre 
lumen 

ampere  per  metre 

weber 

tesla 

ampere 

watt 

pascal 

coulomb 

joule 

watt  per  steradian 

joule  per  kilogram-kelvin 

pascal 

watt  per  metre-kelvin 
metre  per  second 
pascal-second 
square  metre  per  second 
volt 

cubic  metre 
reciprocal  metre 
joule 


SI  Symbol  Formula 

m 

kg 


A 

K 


mol 

cd 

rad 

sr 

m/s 

(disintegration  )/s 
rads 

rad’s 

m 

kgm 

F 

A-s/V 

S 

A/V 

V'm 

H 

V-*A 

V 

VV/A 

V/A 

V 

W/A 

1 

N-m 

I'K 

N 

kg-m's 

Hz 

(cycle)/s 

lx 

lm'm 

cdm 

lm 

cd-sr 

A/m 

Wb 

Vs 

T 

Wb'm 

A 

W 

I’S 

Pa 

N/m 

C 

I 

A-s 

N-m 

W/sr 

)/kg-K 

Pa 

N/m 

W/m-K 

m/s 

Pa-s 

ms 

V 

W/A 

m 

i 

(wave|/m 

N-m 

[ 

I : 


l 

* 
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SI  PREFIXES: 


Multiplication  Factors 

Prefix 

SI  Syn 

i ooo  ooo  ooo  ooo  = in1* 

tera 

T 

1 000  000  000  = 10' 

8>«a 

(• 

1 000  000  = 10* 

mega 

M 

1 000  « 10’ 

kilo 

k 

100  = 101 

hecto* 

h 

10  = 10’ 

deka* 

da 

0 1=  10-’ 

decl* 

d 

001  = 10-> 

cent!" 

r. 

0001  = 10-> 

mill! 

m 

0 000  001  = 10-* 

mlcrti 

M 

0 000  000  001  * 10-' 

nano 

n 

0 000  000  000  001  * 10- ” 

pico 

p 

0 000  000  000  OOO  001  = 10- " 

lemlo 

1 

0 000  000  000  000  000  001  = 10-" 

alto 

a 

* To  be  avoided  where  passible 
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